Tips For Writing Good WordPress Tips

July 9, 2007 | By Lorelle VanFossen | Filed Under Features, WordPress

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:

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


About the author: The author of Lorelle on WordPress, as well as several other blogs, Lorelle VanFossen has been blogging in one fashion or another for over 14 years, covering travel, nature and travel photography, web design, web theory and development, blogging, and WordPress extensively as web technologies developed. Lorelle is also the author of the fast-selling book, Blogging Tips: What Bloggers Won't Tell You About Blogging, available in the new Blog Herald Bookstore. Lorelle will be speaking at WordCamp Dallas March 29-30, the Alliance for Distance Education in California Summit April 2-5, 2008, and the Successful and Outstanding Bloggers Conference May 2-5 in Chicago.



Comments

31 Responses to “Tips For Writing Good WordPress Tips”

  1. Creative resources 09 July 2007 : David Airey :: Creative Design :: on July 9th, 2007 7:55 am

    […] tips for WordPress. If you’re the author of one, I’d recommend reading Lorelle’s Tips for Writing Good WordPress Tips, over on Blog […]

  2. Amrit Hallan on July 9th, 2007 8:01 am

    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.

  3. Tips for Writing Good WordPress Tips, from Lorelle : Reviews of Wordpress Plugins and Themes | Testing Free WordPress Themes | Wordpress Tutorials and Tips on July 9th, 2007 4:22 pm

    […] Blog Herald has a very applicable post up right now by Lorelle called Tips for Writing Good WordPress Tips. It’s all about good practice and technique when it comes to creating great material focusing […]

  4. Tris Hussey on July 9th, 2007 8:32 pm

    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!

  5. Weblog Qjm.be » Blog Archive » Tips For Writing Good WordPress Tips on July 10th, 2007 5:58 am

    […] óver WordPress en derhalve WordPress-expert, maar eens een lijstje heeft samengesteld van tips voor mensen die tips voor WordPress-webloggers willen schrijven. Snapt men het nog? Het gaat er om dat er nogal wat webloggers zijn die pretenderen verstand te […]

  6. Tips for Writing WordPress Tips « Lorelle on WordPress on July 11th, 2007 1:13 am

    […] tips on their blog, or with me to recommend to my readers and WordPress fans, I’ve written Tips For Writing Good WordPress Tips on the Blog Herald that will […]

  7. Tipps für das Schreiben guter WordPress Tipps | bueltge.de [by:ltge.de] on July 11th, 2007 4:19 am

    […] diesem Thema befasst Lorelle auf Blog Herald in einem aktuellen Artikel. Angesichts der Tatsache, dass die Anzahl der Tipps zur Webpublishing Plattform WordPress immer […]

  8. Internet Blogs » Blog Archive » Tipps für das Schreiben guter WordPress Tipps on July 11th, 2007 4:26 am

    […] diesem Thema befasst Lorelle auf Blog Herald in einem aktuellen Artikel. Angesichts der Tatsache, dass die Anzahl der Tipps zur Webpublishing Plattform WordPress immer […]

  9. Easton Ellsworth on July 11th, 2007 6:55 am

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

  10. Free as in Time » Blog Archive » Wordpress Wednesday 11/07/2007 on July 11th, 2007 2:19 pm

    […] Tips For Writing Good WordPress Tips - For those who write, rather than just listing links. 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. […]

  11. NO Wordpress or Word Press: Spell WordPress Correctly! on July 11th, 2007 3:18 pm

    […] realization came from a post by Lorelle on writing good WordPress tips, where she says WordPress is a trademark and must be spelled appropriately. This has been explained […]

  12. Resulta que se escribe WordPress...ni Wordpress, ni Word Press — RegioBlogs on July 11th, 2007 4:57 pm

    […] Mas de este asunto aqui […]

  13. Write WordPress Correctly! · Adsensetips on July 13th, 2007 10:33 am

    […] realization came from a post by Lorelle on writing good WordPress tips, where she says WordPress is a trademark and must be spelled appropriately. This has been explained […]

  14. Tipps zum Schreiben guter WordPress-Artikel - Tobbis Blog - Aktuelles über Windows, Opera & Co. gebloggt von Tobias Steinicke on July 15th, 2007 6:57 am

    […] schreibe ich gute WordPress-Artikel? Einige Tipps dazu gibt es drüben bei BlogHerald von […]

  15. Pierro on July 15th, 2007 1:24 pm

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

  16. Best of Feeds - 37 links - google, blogging, facebook, wordpress, tips « Internet Duct Tape on July 18th, 2007 12:18 pm

    […] [WORDPRESS] Tips For Writing Good WordPress Tips (blogherald.com, 15 inbound links) […]

  17. wordpress quickstart guy on August 12th, 2007 2:14 am

    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!

  18. Blog Challenge: Your Favorite WordPress Tip « Lorelle on WordPress on September 7th, 2007 10:37 am

    […] highly recommend that you read Tips For Writing Good WordPress Tips, my guide on how I determine which articles featuring WordPress tips to include in my weekly […]

  19. A Thinking Communicator - a Peek Inside Lorelles Head : Circular Communication on September 10th, 2007 8:36 pm

    […] explanations of WordPress Plugins led me to write A Love Letter to WordPress Plugin Authors and Tips For Writing Good WordPress Tips, hopefully helping WordPress Plugin and Theme authors, and anyone who writes WordPress tips, to get […]

  20. Mark Penix on September 28th, 2007 8:11 am

    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!

  21. Lorelle on Writing for WordPress | Bloggercamp on September 28th, 2007 8:13 am

    […] a little dated but such a great read. Tips For Writing Good WordPress Tips Related PostsBloggercamp is GrowingCreating Asides in WordPress 2.3Popularity: unranked [?]Share […]

  22. Whose Talking About You and Your Blog : The Blog Herald on October 16th, 2007 10:34 am

    […] also took time to dig into their blog content, occasionally finding helpful tips and techniques for using WordPress that I can references here or on my blog, introducing these bloggers to my readers and spreading […]

  23. What Do I Blog About? : The Blog Herald on October 22nd, 2007 10:09 am

    […] your tips, advice, techniques, and how-tos to your blog to help people learn how to do what you know how to do. We come to learn from your […]

  24. Meldungen on November 2nd, 2007 12:39 am

    Thanks for sharing this.

  25. Considering Writing Some WordPress Tips? « Lorelle on WordPress on January 2nd, 2008 12:58 pm

    […] Well: Read Tips For Writing Good WordPress Tips for tips on how to write even better WordPress […]

  26. Eric on January 5th, 2008 7:32 pm

    I “pore” through . . .

  27. Eric on January 5th, 2008 7:34 pm

    . . . they are presenting?

  28. Lorelle VanFossen on January 5th, 2008 7:49 pm

    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.

  29. MOST MOST » Blog Archive » NO Wordpress or Word Press: Write WordPress Correctly! on January 16th, 2008 12:52 am

    […] realization came from a post by Lorelle on writing good WordPress tips, where she says WordPress is a trademark and must be spelled appropriately. This has been explained […]

  30. Tips For Improving Your WordPress Skills | www.searchforblogging.com on March 9th, 2008 4:40 am

    […] Effective Tips For Writing Good WordPress Tips […]

  31. Blogging-Tips oder Bloggen-Tipps? bei Web.LeoXP.de on April 24th, 2008 12:37 pm

    […] Tips For Writing Good WordPress Tips […]

Leave a Reply




Contributors

Bloggy Award

Latest Reviews

More at Blogosphere News

Submitted News

Our Blog Metrics

Recommended

Splashpress Media

Powered by WordPress | Designed by Brian Gardner
Copyright © 2003 - 2008 by The Blog Herald - All Rights Reserved