andi
(Administrator)
Show profile
Link to this post
Subject: Help improving the plugin pages
A lot of functionality in DokuWiki is achieved by plugins, so they are a very important aspect of the system.
Håkan Sandell took the time to write a script to analyze all existing plugins and their documentation to find out where improvements should be made. This gives us the opportunity to approach these improvements in a very structured way. The findings of his survey are available here: Plugin Survey 2009. Take the time to read through it - it has a lot of interesting info.
Now we need your help to make use of the data. The good thing is that you don't need any programming knowledge for most of the tasks.
Here are a few ideas on what you could do:
If you have questions on how to approach one of the mentioned tasks or want to do something else, just reply to this thread.
Håkan Sandell took the time to write a script to analyze all existing plugins and their documentation to find out where improvements should be made. This gives us the opportunity to approach these improvements in a very structured way. The findings of his survey are available here: Plugin Survey 2009. Take the time to read through it - it has a lot of interesting info.
Now we need your help to make use of the data. The good thing is that you don't need any programming knowledge for most of the tasks.
Here are a few ideas on what you could do:
- Update pages for Plugins without a package to use the new downloadable code block syntax. Eg change <code>...</code>to<code php syntax.php>...</code>
- Try to fix broken download links by finding the correct link, contacting the author or finding someone who still has the code (eg. by asking in the forum)
- Clean up the pages of bundled plugins by updating the tags, adding usage guides and removing comments/questions and integrate answers into the documentation
- Add compatibility infos. If you are using a plugin with a certain DokuWiki version just add the version to the compatibility field.
- Programmers could try to fix the broken and insecure plugins or fix CSS incompatibilities. If the original author doesn't respond anymore you could adopt the plugin yourself.
- Add plugin names to the example section of the respective events using the list of Who uses this Event?
- Clean up the plugin pages by updating the tags, adding usage guides and removing comments/questions and integrate answers into the documentation
- Add descriptions and screenshots to plugins using external download pages
- rename wrongly named pages (just copy and paste)
- Remove or fix non-plugin pages
If you have questions on how to approach one of the mentioned tasks or want to do something else, just reply to this thread.
This post was edited on 2009-09-16, 13:42 by 
