Tips For Writing Good WordPress Tips

Filed as Features on July 9, 2007 3:23 am

Repost This

Haven’t you started to doubt blogs which offer great WordPress tips when they aren’t published on WordPress blogs?

I pour through hundreds of blogs and blog posts every week in search of WordPress news, tips, techniques, Plugins, and information for the Blog Herald WordPress Wednesday News. Call me arrogant. Call me inconsiderate. Call me whatever you want, but over the past six months, I’ve found myself developing some criteria for whether or not I will link to a blog with WordPress resources because I doubt their sincerity and integrity.

Here are some of the criteria I’m starting to use to judge a blog for inclusion on my blog and on the Blog Herald.

WordPress versus WordPress

WordPress is a trademark and thus must be spelled appropriately. This has been explained redundantly, so when I see a blog post with WordPress not WordPress and WordPress plug-in not WordPress Plugin, the article loses some of its luster.

I try to ignore it, but it does score a bit against the credibility of the author who should know better. It isn’t a killer but it does downgrade my score for inclusion.

Why? If their attention to detail skips the proper spelling of these words, what does that say for the information they are presenting. What little detail has been overlooked or ignored? Should I risk recommending something that might be flawed?

If You Are Blogging About WordPress, Blog on WordPress

I know many writers publish articles about WordPress on multiple bloggers blogs not run on WordPress. I can forgive that. But when I run across a Blogspot or TypePad blog spouting expertise on WordPress, I’m a little doubtful as to their expertise. Aren’t you?

I can rave all I want about the pros and cons of driving a Ferrari. If you find out that I’ve never been in one nor driven one, wouldn’t you doubt my veracity? I would.

Unless the tip and technique is really unique and well-written, it’s hard for me to publish a link recommendation to a blog not run on WordPress about a WordPress technique. So yes, I’m prejudice, but with good reason. I want to know that the author has “been there, done that, lived to tell about it” on their WordPress blog. Don’t you?

Code Without Character Entities

I look long and hard at blog posts which include code to see if they have properly replaced all quote marks and apostrophes with the proper character codes (” is " and ‘ is '). I look to see that they haven’t put spaces around the code (< p > instead of <p>) or inappropriate line breaks, and other methods people use to force code to display on their blogs.

There are several ways to display code in your blog posts. Making it messy and unable to be easily copied and pasted into a WordPress template file puts a burden on the reader. It also leads to increased technical support and comments like “Help! I can’t get this to work!”

The same goes for WordPress Plugins and scripts which make the user jump through hoops to get it to work.

Plugins and scripts can easily be stored in a zip file for easy downloading and use. Long bits of code for copying and pasting into a blog template file should be featured in a file for downloading and viewing not displayed on a blog post, filling it up with hard to read code. Breaking code up into little pieces, then never supplying the final collection of all those bits forces the user to copy and paste those bits together, creates potential errors and problems which has them coming back with “Help! I can’t get this to work!”

Display code cleanly and concisely. Provide additional files and readme files to explain how to use these in addition to information published on your blog.

If the idea is unique and really good and the display of code is poor, I may let it slide, with a disclaimer, but if the display of code is really bad and will cause more suffering for the reader than it should, I will skip it.

Here are some articles I’ve written on how to write code in your WordPress blogs:

Rambling Stories

While I like to know how the blogger came up with the tip or technique, it’s not as important as the tip or technique. If I have to scroll through paragraph and paragraph of back story to get to the tip, I will skip it, unless it really offers a unique instruction and technique I’ve not found elsewhere.

Trust me, it’s not fun to feature a blog post with a disclaimer that says, “Be patient and just read through the first 8 paragraphs and then you will get to the good stuff.” Sometimes, that’s exactly what I want to say in my recommendations. Don’t give me that opportunity.

Too Many Ads Before and Within the Content

I’ve found many really good technical articles for WordPress bloggers that are buried in 8-25 advertisements. If I have to dig through the ads, just like digging through rambling back stories, I will not recommend the article to my readers.

Why should I recommend something to them that will tick them off when they visit? The last thing I want to do when making a recommendation is annoy my readers. They’ve come to trust me to provide them with the information they need from an easy-to-read and accessible site. I work hard not to disappoint.

It’s not just too many ads, it’s also link ads within the content. If I see WordPress turned into an advertising link, it just kind of hits me where it hurts. I am really annoyed by link ads which turn “random” words in a blog post into advertising, especially when they include the dreaded popup ads.

If the design, readability, and usability of the blog is filled with interference, whether they come from ads or other design decisions, I will not recommend that blog post to my readers.

Mind Reading Writing

Most people arrive on your blog through search engines. The first page we see is the first page we see. We arrive not knowing the back story, history, or the long term challenges you’ve had to finally come up with tip or technique that solved your problem. You have to tell us.

I’ve found many wonderful answers to WordPress problems that began with “I finally found the answer to my problem. Do this…” without any description of what the problem was or why it needed fixing. I’ve even found descriptions of WordPress Plugins by their authors that start out with “Okay, it’s finished. Take a look at it and tell me what you think of it.”

How can we know what you are talking about, or do anything with the information you offer, unless we understand why it’s important, what it solves, and why we should try it.

Don’t assume we know what you are talking about, have been reading your blog and know the history, or we can read your mind. You must tell us before we can use the information, and I have to know before I recommend your information.

Copying Other People’s Code and Explanations

It’s wonderful to share. It should be a compliment to copy someone else’s work and make it your own, by adding a few twists and turns to the content. But it’s not yours.

Give credit where credit is due. When I find an article with a WordPress technique in it, with a link to the original source of the “inspiration”, I check it out. If I find that the article I just visited is almost a duplicate, or explains the technique in almost the same terms, with a majority of the code from the original source, I’m not likely to give credit to the copying blog.

When you add to the body of WordPress knowledge, people want to give you the credit you deserve. So do I. But when you copy the work of others and don’t really add more information, you are just duplicating content not increasing it.

Do you know how many articles are out there giving almost the same instructions on installing a WordPress blog as are in the WordPress Codex? According to Google, give or take a few thousand, there are 1,740,000 web pages on installing WordPress. Do we really need any more?

Everyone wants to share their version of how to do it, but when it’s been shared over a thousand times, then what new things do you bring to the table?

It’s hard to write some WordPress technique articles without “borrowing” code and tips from others. Give credit where credit is earned, but present the information in a new way, through new eyes, with a new twist on the perspective, not just because you think you can write it better.

If You Are the Source, Say So

With the plethora of splogs on the web, it’s important for me to know you are the source of the information, WordPress Plugin, or WordPress Theme. Many will ramble on about a Plugin, script, or Theme, making me believe they are the author when at the bottom, there is a link to another blog. What? Who? Where?

If you are not the source, say so. If you are the source, say so. Make it clear from the beginning that this is your concept, your original creation, your code.

If you are reviewing or referencing another WordPress Plugin, Theme, or script, then say so at the very beginning so we know this is not your work, that you are recommending the work of someone else.

Again, give credit where credit is due, and if it is you, say so.

How to Write a Good WordPress Tip

Now you know how hard it is to filter through hundreds of articles offering WordPress and blogging tips every week. I didn’t plan on setting up this self-filtering system, but it’s important to me to bring you the best of the best in WordPress news, tips, techniques, and resources. Over time, I learned to weed out the wheat.

If you are writing a blog post on WordPress, here are my tips to get past my filter, and hopefully impress your readers and visitors with your WordPress expertise so they will recommend your post:

  • Spell WordPress and Plugins right.
  • Spell check and use complete words and sentences. Make it easy to read.
  • Make your blog a WordPress blog, or make sure we know your WordPress expertise from the moment we arrive on your blog.
  • Publish your code to be copied and pasted directly.
  • Get to the point.
  • Explain the reasons, benefits, and flaws in what you are offering clearly.
  • Provide instructions in a step-by-step manner rather than paragraph-by-paragraph.
  • Make the content more important than the money-making process on your blog.
  • Make us believe you know what you are talking about.
  • Write for an international audience.
  • Don’t plagiarize.
  • Give credit where credit is due.
  • Provide links to related resources for substantiation as well as more information.
  • If this is your work, let us know.

Next time you write a good WordPress tip, technique, or how to, you might just pass my criteria test and be featured here on the Blog Herald or on . I love to make WordPress fans famous, but you have to help me. :D

Tags:

This post was written by

You can visit the for a short bio, more posts, and other information about the author.

Submissions & Subscriptions

Submit the post to Reddit, StumbleUpon, Digg or Del.icio.us.

Did you like it? Then subscribe to our RSS feed!



  1. Creative resources 09 July 2007 : David Airey :: Creative Design ::July 9, 2007 at 7:55 am
  2. By Amrit Hallan posted on July 9, 2007 at 8:01 am
    Want an avatar? Get a gravatar! • You can link to this comment

    Hi Lorelle.

    Thanks for sharing this. Although I don’t plan to write a WordPress plugin I do agree that small things matter, and not only regarding WordPress, but regarding everything. When you show your attention for smaller details, it shows you respect your work.

    Reply

  3. Tips for Writing Good WordPress Tips, from Lorelle : Reviews of Wordpress Plugins and Themes | Testing Free WordPress Themes | Wordpress Tutorials and TipsJuly 9, 2007 at 4:22 pm
  4. By Tris Hussey posted on July 9, 2007 at 8:32 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    I finally moved my personal blog over to WP this weekend! I’ve been deploying sites and blogs on WP for a long while.

    Thank you for clarifying WordPress vs WordPress … always wondered which was correct!

    Reply

  5. Weblog Qjm.be » Blog Archive » Tips For Writing Good WordPress TipsJuly 10, 2007 at 5:58 am
  6. Tips for Writing WordPress Tips « Lorelle on WordPressJuly 11, 2007 at 1:13 am
  7. Tipps für das Schreiben guter WordPress Tipps | bueltge.de [by:ltge.de]July 11, 2007 at 4:19 am
  8. Internet Blogs » Blog Archive » Tipps für das Schreiben guter WordPress TippsJuly 11, 2007 at 4:26 am
  9. By Easton Ellsworth posted on July 11, 2007 at 6:55 am
    Want an avatar? Get a gravatar! • You can link to this comment

    Lorelle, you are a genius. Thank you, thank you.

    Reply

  10. Free as in Time » Blog Archive » Wordpress Wednesday 11/07/2007July 11, 2007 at 2:19 pm
  11. NO Wordpress or Word Press: Spell WordPress Correctly!July 11, 2007 at 3:18 pm
  12. Resulta que se escribe WordPress...ni Wordpress, ni Word Press — RegioBlogsJuly 11, 2007 at 4:57 pm
  13. Write WordPress Correctly! · AdsensetipsJuly 13, 2007 at 10:33 am
  14. Tipps zum Schreiben guter WordPress-Artikel - Tobbis Blog - Aktuelles über Windows, Opera & Co. gebloggt von Tobias SteinickeJuly 15, 2007 at 6:57 am
  15. By Pierro posted on July 15, 2007 at 1:24 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    today was my premiere on your blog. Wow, nice one !
    i guess, now im read more frequently past …

    Reply

  16. Best of Feeds - 37 links - google, blogging, facebook, wordpress, tips « Internet Duct TapeJuly 18, 2007 at 12:18 pm
  17. By wordpress quickstart guy posted on August 12, 2007 at 2:14 am
    Want an avatar? Get a gravatar! • You can link to this comment

    I was on blogger and have countless of problems until I give up and turn to wordpress. Thanks to wordpress now, I can find my past articles easily.

    I like the information you wrote and certainly I am into writing tips for my students on wordpress.

    CheerS!

    Reply

  18. Blog Challenge: Your Favorite WordPress Tip « Lorelle on WordPressSeptember 7, 2007 at 10:37 am
  19. A Thinking Communicator - a Peek Inside Lorelles Head : Circular CommunicationSeptember 10, 2007 at 8:36 pm
  20. By Mark Penix posted on September 28, 2007 at 8:11 am
    Want an avatar? Get a gravatar! • You can link to this comment

    I thought I was the only one with the pet peeve with the whole WordPress vs. WordPress thing (or gasp separating the words!?!!)

    Great post Lorelle!

    Reply

  21. Lorelle on Writing for WordPress | BloggercampSeptember 28, 2007 at 8:13 am
  22. Whose Talking About You and Your Blog : The Blog HeraldOctober 16, 2007 at 10:34 am
  23. What Do I Blog About? : The Blog HeraldOctober 22, 2007 at 10:09 am
  24. By Meldungen posted on November 2, 2007 at 12:39 am
    Want an avatar? Get a gravatar! • You can link to this comment

    Thanks for sharing this.

    Reply

  25. Considering Writing Some WordPress Tips? « Lorelle on WordPressJanuary 2, 2008 at 12:58 pm
  26. By Eric posted on January 5, 2008 at 7:32 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    I “pore” through . . .

    Reply

  27. By Eric posted on January 5, 2008 at 7:34 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    . . . they are presenting?

    Reply

  28. By Lorelle VanFossen posted on January 5, 2008 at 7:49 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    Eric, this word has been “corrected” several times. Pore can mean to intensely scrutinize, and pour has several meanings including “move in large numbers” and “supply in large amounts or quantities”. I used the word on purpose due to the vast volumes of articles I’ve read through. Imagine them coming out of a bucket over my head and I’m drowning in them. Swimming. :D Thanks for the correction and the chance to play word games.

    Reply

  29. MOST MOST » Blog Archive » NO Wordpress or Word Press: Write WordPress Correctly!January 16, 2008 at 12:52 am
  30. Tips For Improving Your WordPress Skills | www.searchforblogging.comMarch 9, 2008 at 4:40 am
  31. Blogging-Tips oder Bloggen-Tipps? bei Web.LeoXP.deApril 24, 2008 at 12:37 pm
  32. By raj posted on June 2, 2008 at 4:37 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    Excellent advice. Every time a write a WordPress tip on Performancing.com (set up on Drupal), I wonder how many people are thinking, “What an idiot. This site isn’t even in WordPress.” Extremely frustrating, to be honest.

    Reply

  33. By Lorelle VanFossen posted on June 2, 2008 at 6:26 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    @raj:

    LOL. Why Performancing is still on Drupal is one of those questions that perplex many, so you are not alone. Still, as a contributor, you can still write about WordPress on any platform and no one should think the less of you…I hope. :D

    Thanks for the great work you do, Raj. You are one of the great ones in this industry.

    Reply

  34. By Xavier posted on July 16, 2008 at 11:34 am
    Want an avatar? Get a gravatar! • You can link to this comment

    I’m about to deploy my second blog. You helped me tighten my style up. Thanks.

    Reply

  35. By carlos posted on July 31, 2008 at 1:40 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    Great! Thank you…

    Reply

  36. By Jobs posted on September 6, 2008 at 8:21 am
    Want an avatar? Get a gravatar! • You can link to this comment

    GReat article! Thanks for the tips!

    Reply

  37. WP Limits » Blog Archive » Navigation Tips: Suckerfish, Sliding Doors, and BreadcrumbsSeptember 15, 2008 at 9:44 am
  38. By Banana Lee Fishbones posted on November 20, 2008 at 1:55 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    Lorelle, most of these tips are good for BLOG posts, not just WordPress tips! This is stuff everybody should know. Which to/two/too and loose/lose and their/they’re/there are things that automatically lose you some points. Get to the point, give context, show credit, all of those are good for every post, not just those we want you to read. (:

    Reply

  39. By adivya yadav posted on December 30, 2008 at 12:16 am
    Want an avatar? Get a gravatar! • You can link to this comment

    Hey thanks,
    That was a wonderful collection of tips .It surely will help a new blogger like me.

    Reply

  40. By Erynion posted on January 16, 2009 at 12:16 am
    Want an avatar? Get a gravatar! • You can link to this comment

    Thank you, Lorelle, for an extremely interesting read. I just graduated from using blogger, to starting my first WordPress powered website. The nuances of writing to an audience impressed on me greatly.

    While I have no clue about writing WordPress tips, I will take the core of the post and implement in the way I write. This will undoubtedly help my cause. Again, thank you.

    Reply

  41. WordPress News: WordPress.tv, WordCamp Whistler, WordPress Logo, City Saves Money, and More | The Blog HeraldFebruary 4, 2009 at 12:30 pm
  42. Theme PlaygroundFebruary 17, 2009 at 10:18 am
  43. By Webstractions posted on March 10, 2009 at 11:08 am
    Want an avatar? Get a gravatar! • You can link to this comment

    Very nice of you to share your vetting process, Lorelle.

    For what it is worth, I don’t think I have to worry about bullet point #8 then. Will scratch that one off my proofing list.

    Also, if you want to get really technical about the WordPress name, shouldn’t it be WordPress™?

    Reply

  44. Changing the Blog Herald WordPress News: Your Help Needed | The Blog HeraldMarch 10, 2009 at 5:46 pm
  45. Round WordPress: Summer of Code, Kubrick Retired, How Tos, WebWare 100, and WordPress Fan Blogs « Lorelle on WordPressApril 6, 2009 at 5:40 pm
  46. By mentorlog posted on December 6, 2010 at 1:42 pm
    Want an avatar? Get a gravatar! • You can link to this comment

    May be this post is quiet old but still but still tips are really great. Thanks for sharing

    Reply

    Your words are your own, so be nice and helpful if you can. If this is the first time you're posting a comment, it might go into moderation. Don't worry, it's not lost, so there's no need to repost it! We accept clean XHTML in comments, but don't overdo it please.

    Current day month ye@r *