WordPress Ideas » Topic: better instructions for plug-ins https://wordpress.org/ideas/topic/better-instructions-for-plug-ins WordPress Ideas » Topic: better instructions for plug-ins en-US Mon, 12 Jun 2017 02:54:46 +0000 http://bbpress.org/?v=1.1 danielwalters6 on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5921 Mon, 02 Jun 2008 22:54:04 +0000 danielwalters6 5921@https://wordpress.org/ideas/ Hi - fairly new to PHP and all this - however with a very limited Visual Basic knowledge (ie what's going on in an IF statement) I've managed to work out what's happening throughout most of the plugins that I've created.

I don't think instructions are the key to solving this issue, I believe COMMENTS is what are required more in the source code - Instructions to install are brilliant, instructiosn on where to get more help is also great. - No one can provide you with instructions on how to expand on a plugin - or the mod would have already been made!

PHP Comments are required - infact 50% of my programs I build are comments!!!

]]> detoam on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5913 Sun, 01 Jun 2008 17:52:08 +0000 detoam 5913@https://wordpress.org/ideas/ Thank you. I think You are right that if it is too hard to understand how to use something it isn't worth using. Sadly I am one of those people who just can't stand not knowing how things work.

]]> Justin Tadlock on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5905 Sat, 31 May 2008 19:02:48 +0000 Justin Tadlock 5905@https://wordpress.org/ideas/

Therefore it is an idea.

Yes, it's an idea; I never said it wasn't. I only proposed that it wasn't a good idea for the ideas forum.

From the front page of the Extend section of this site:
http://wordpress.org/extend/

WordPress Ideas

Our ideas forum is where you can suggest and vote on ideas for where WordPress should go next. We're implementing the most popular features from the suggested ideas. The future is in your hands.

This has also been pretty much extended to ideas for new plugins. I suspect most plugin authors don't read this. The WordPress development team has no control over how well instructions are written.

...but the attitude that creating free to use software means that one can do a shotty work is extremely wrong.

Agreed. Sometimes, people make crappy things in both the free and paid software world.

The ideas forum isn't going to change how plugin authors post instructions. If it's too hard for a beginner to figure out with the instructions given, then it might not be worth using.

]]> detoam on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5902 Sat, 31 May 2008 05:57:21 +0000 detoam 5902@https://wordpress.org/ideas/ Firstly Open source does not mean free things. open source simply means that the software isn't encoded.
Secondly as a crator of free to use software I take pride in knowing that people who use my work have a full understanding of how they can use it.
I don't mean to flame on your parade, but the attitude that creating free to use software means that one can do a shotty work is extremely wrong. part of creating something that is free to use is trying to make it so people who have little knoweledge can fully understand. Therefore it is an idea. An idea to improve a great product. As the statement "Code is poetry" states. Poetry is for everyone and therefore should be simple enough for a fresh person to be understood. Just like the works of E.A.Poe.

]]> Justin Tadlock on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5900 Fri, 30 May 2008 18:37:24 +0000 Justin Tadlock 5900@https://wordpress.org/ideas/ Part of maintaining your own blog means, especially with open source software, learning a little about how things work. Sure, better instructions would be great, but that's not always going to happen.

Voting down because I believe this isn't really something for the Ideas forum.

]]> teambiff on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5894 Fri, 30 May 2008 08:16:20 +0000 teambiff 5894@https://wordpress.org/ideas/ Nice plea but you get what you pay for with open source stuff. The WP forums would probably help you best.

]]> detoam on "better instructions for plug-ins" https://wordpress.org/ideas/topic/better-instructions-for-plug-ins#post-5885 Thu, 29 May 2008 21:08:48 +0000 detoam 5885@https://wordpress.org/ideas/ Hi there!
I am new to PHP and I am sure I am not alone. Most plug-ins come with extremely little instructions and most of what is there is written for those that know exactly what they are doing. And more often than not a person gets reffered to some other site for support where a person has to register before they can even ask a question. It's hard to keep track of all those sites. I already have membership in about 200 sites that are really important. Anyways what I am suggesting is that developers think in terms of regular users and write the instructions accordingly. Please.

]]>