Hi plugin maintainer of geany-plugins,
As 0.21 is near I like to ask you to update your documentation for your plugin. Some of them are pretty out of date and not very useful to the user.
Please check that they include the latest information as e.g. authors mail addresses, web pages, features, know issues, bug tracker links etc..... But also make sure the user is understanding how the plugin works and how he can make usage of it.
Thanks in advance, Frank
P.S. I'm honestly personally thinking about to don't include a plugin which is not having a minimum of good documentation to upcoming releases...
On 08/29/2011 08:35 AM, Frank Lanitz wrote:
Hi plugin maintainer of geany-plugins,
As 0.21 is near I like to ask you to update your documentation for your plugin. Some of them are pretty out of date and not very useful to the user.
Just a reminder also, someone should update the Plugins page on geany.org as it lists some but not all of the current plugins and also lists the recently removed GeanyEmbrace. Might be a good time before the release to review all the content on that page[1].
[1] http://www.geany.org/Support/Plugins
Cheers, Matthew Brush
Am 30.08.2011 03:08, schrieb Matthew Brush:
On 08/29/2011 08:35 AM, Frank Lanitz wrote:
Hi plugin maintainer of geany-plugins,
As 0.21 is near I like to ask you to update your documentation for your plugin. Some of them are pretty out of date and not very useful to the user.
Just a reminder also, someone should update the Plugins page on geany.org as it lists some but not all of the current plugins and also lists the recently removed GeanyEmbrace. Might be a good time before the release to review all the content on that page[1].
I've updated the page a bit :)
Cheers, Frank
On 08/30/2011 12:53 AM, Frank Lanitz wrote:
Am 30.08.2011 03:08, schrieb Matthew Brush:
On 08/29/2011 08:35 AM, Frank Lanitz wrote:
Hi plugin maintainer of geany-plugins,
As 0.21 is near I like to ask you to update your documentation for your plugin. Some of them are pretty out of date and not very useful to the user.
Just a reminder also, someone should update the Plugins page on geany.org as it lists some but not all of the current plugins and also lists the recently removed GeanyEmbrace. Might be a good time before the release to review all the content on that page[1].
I've updated the page a bit :)
You missed:
"The Geany-Plugins project is a combined release for each matching Geany release, starting with version 0.17. It includes Addons, GeanyDoc, GeanyGDB, GeanyLaTeX, GeanyLipsum, GeanyLua, GeanySendMail, GeanyVC, Shiftcolumn, Spell Check."
If those are the "preferred" plugins, at least it should say:
"It includes Addons, GeanyDoc, GeanyGDB, GeanyLaTeX, GeanyLipsum, GeanyLua, GeanySendMail, GeanyVC, Shiftcolumn, Spell Check, and many others."
Also, this should not say "editable":
"There is an editable plugin wishlist page, but be aware this may contain malicious links."
And while in that page, maybe the completed items from that wishlist should be in a strike-through font. There are quite a few items that are now complete from a quick glance.
Cheers, Matthew Brush
On Tue, 30 Aug 2011 06:54:29 -0700 Matthew Brush mbrush@codebrainz.ca wrote:
On 08/30/2011 12:53 AM, Frank Lanitz wrote:
Am 30.08.2011 03:08, schrieb Matthew Brush:
On 08/29/2011 08:35 AM, Frank Lanitz wrote:
Hi plugin maintainer of geany-plugins,
As 0.21 is near I like to ask you to update your documentation for your plugin. Some of them are pretty out of date and not very useful to the user.
Just a reminder also, someone should update the Plugins page on geany.org as it lists some but not all of the current plugins and also lists the recently removed GeanyEmbrace. Might be a good time before the release to review all the content on that page[1].
I've updated the page a bit :)
You missed:
"The Geany-Plugins project is a combined release for each matching Geany release, starting with version 0.17. It includes Addons, GeanyDoc, GeanyGDB, GeanyLaTeX, GeanyLipsum, GeanyLua, GeanySendMail, GeanyVC, Shiftcolumn, Spell Check."
If those are the "preferred" plugins, at least it should say:
"It includes Addons, GeanyDoc, GeanyGDB, GeanyLaTeX, GeanyLipsum, GeanyLua, GeanySendMail, GeanyVC, Shiftcolumn, Spell Check, and many others."
Also, this should not say "editable":
"There is an editable plugin wishlist page, but be aware this may contain malicious links."
Just updated again the page. I hope now its a bit better ;)
And while in that page, maybe the completed items from that wishlist should be in a strike-through font. There are quite a few items that are now complete from a quick glance.
Maybe we should move this to wiki anyway.
Cheers, Frank
On 08/30/2011 12:31 PM, Frank Lanitz wrote:
On Tue, 30 Aug 2011 06:54:29 -0700 Matthew Brushmbrush@codebrainz.ca wrote:
Just updated again the page. I hope now its a bit better ;)
Yep, looks good!
And while in that page, maybe the completed items from that wishlist should be in a strike-through font. There are quite a few items that are now complete from a quick glance.
Maybe we should move this to wiki anyway.
That's what I was thinking too, so I made a page:
http://wiki.geany.org/plugins/wishlist
Only I don't know how to make it accessible through some index/table of contents/menu. Also, since I can't edit the geany.org site, I can't properly copy the markup from the existing wishlist. If you don't mind seeing if you can do a copy/paste from there to this new page to see if you can retain the bullet list and strike-through fonts, that would be cool. I left a TODO note for this.
Cheers, Matthew Brush