Writing beginner level tutorials. A number of useful tips. My favorite: “use words and phrases that your reader can Google to find more information.” For producers of documentation, I think the biggest challenge is putting yourself in the mindset of the reader. The second biggest challenge is closing the feedback loop between the person who has the knowledge and the person who wants the knowledge.
Today we differentiate between blogging on blogging platforms and sharing on social platforms, but that is just semantics. The essence of blogging is not defined by a platform but by what I learned from Dave and his blogging platform — that media now is raw, collaborative and instantaneous.
Blogging is communal: In 2008, I wrote that “blogging is not just an act of publishing but also a communal activity. It is more than leaving comments; it is about creating connections.” That is the single biggest lesson learned of these past 10 years. Every connection has lead to a new idea, new thought and a new opportunity.
Being authentic in your thoughts and voice is the only way to survive the test of time.
Being wrong is as important as being right. What’s more important — when wrong, admit that you are wrong and listen to those who are/were right.
Om Malik — My 10 years of blogging: Reflections, Lessons & Some Stats Too
Meet wpshell – the power of WordPress at your prompt. wpshell is an undiscovered gem. Someone should lead a WordCamp talk about it and the secrets it holds.
In other words, my theory is: Cheating (on a systematic level) happens because students try to get an edge over their peers/competitors. Even top-notch students cheat, in order to ensure a perfect grade. Fighting cheating is not something that professors can do well in the long run, and it is counterproductive by itself. By channeling this competitive energy into creative activities, in which you cannot cheat, everyone is better off.
Panos Ipeirotis — Why I will never pursue cheating again. A computer scientist teaching in a business school details a year of trying to combat cheating on assignments. Overall, he spent 45 hours addressing the problem during a 32 hour lecture course, and 22 of 108 enrolled students admitted cheating. Solutions could include:
- Public projects – All of the work ends up public, so embarrassment is the deterring factor.
- Peer review – Students have to present their work in class, and are judged by others.
- Competitions – Grades are performance-based (e.g. students build websites to attract the greatest number of unique visitors).
Takeaway: If plagiarism is your biggest worry, you’re doing it wrong.
Hyperlocal Post-Mortem: Lessons Learned From InJersey. Fantastic pragmatic takeaways from Ted Mann. Highlights: local advertisers don’t like self-serve, build your site cheaply, and make it ridiculously easy for contributors to publish (e.g. don’t have them email posts to editors, and then require the editor to copy/paste, edit, and then publish).
How hyperlocal has a future. Dave Winer’s advice for publishers: “be sure you control your own publishing and distribution.” NYU has a hyperlocal conclave this Saturday with a tools discussion that’s sure to be fun.
Learning how to learn. Scope out a project and just start.
Readme Driven Development. Write your Readme first.
The following are WordPress plugins I find myself using and recommending regularly. In the interest of making this available to everyone, here’s the full list:
- WordPress.com Custom CSS – Use your own CSS to tweak your website without modifying your theme’s files. Includes a revision history so you can always backtrack to prior versions. This is a feature WordPress.com charges $14.97/year for and has saved the J-School significant pain.
- Co-Authors Plus – Assign multiple bylines to an article. You’ll need to edit your theme templates too for the multiple bylines to appear.
- W3 Total Cache – Speed up the load time of your website with caching. Caching takes a generated page of your website and stores it statically for future use.
- After the Deadline – Spelling, style, and grammar checker powered by artificial intelligence. Catches misused words, passive voice, and cliches.
- Edit Flow – Move your editorial workflow into WordPress with custom post statuses, editorial comments, and calendar and story budget views.
- Post Author Box – Add an informational box about the author to the beginning or ending of every post (or any other post type). Can also be used to add the byline if your theme doesn’t support bylines.
- Google Calendar Events – Parses Google Calendar feeds and displays the events as a calendar grid or list on a page, post or widget. It’s the Google Calendar widget you always wanted.
- Audio Player – Embed MP3 files in your content with a simple shortcode.
- JSON API – For the programmatically-inclined, access all of your content through a JSON API. Useful for pulling content into your website with jQuery.
- Twitter Tools – Automatically publish your articles to Twitter, and pull in your most recent tweets into a widget area.
- Subscribe to Comments – Allow commenters to subscribe to email notifications on threads they’ve commented on. Increase repeat visitors and engagement.
- Emphasis – Paragraph- and sentence-level linking and highlighting. Originally developed for nytimes.com, Michael Donohoe open-sourced the code and Ben Balter made it into a WordPress plugin. Every website should have emphasis.
- Restrict Multisite Plugins – For those running multisite instances, allow your users to activate only a limited number of approved plugins. Interface is very similar to WordPress’ network theme management.
Also, as a part of the documentation we’re continually preparing for the J-School, here are the criteria I follow for adding new plugins:
- GPL-compatible – We can only install plugins on our server that are compatible with the GNU General Public License. This ensures we have the legal right to modify the plugin if it breaks, and make it available to all members of our community. All WordPress.org plugins should be compatible. The license must be packaged with the plugin. Unfortunately, Creative Commons licenses are not GPL-compatible.
- Regularly updated and well-rated – The plugin has been updated in the last 6 months or so by its author. WordPress adds new features regularly, so it’s necessary the developer keep the plugin compatible with the latest version. Active users can also indicate whether the most recent version of the plugin is compatible with the most recent version of WordPress. You can find this information on the right hand of the plugin’s profile page.
- Performs well – A couple of ways you can see whether it’s a good plugin are googling the name of the plugin to see if there’s any negative feedback, or looking in the support forums. If there are a lot of site comments or discussion threads complaining about problems with the plugin, it’s usually a bad sign.