Hello,
Trac has a serious documentation problem. Normally I have 3 types of help
when developing software:
* documentation of the API
* examples
* help by users or developers
Now for Trac I have the problem, that all 3 types fail.
- The online help on the Trac pages is mainly not existing.
- The examples may exist, but can't be found. Whenever I try Google to
find something related to Trac searching for API names or functions I
find lots of patches and bug reports, but never found anything helpful.
- Asking questions on Trac-Devel seems to have no effect at all, as my
mail posted one week ago got not one reply.
I know that documentation is always complicated problem, but if NO way to
get information really works, then the concept is flawed.
I suggest two things:
1) Make the examples in code which surely exist available at the website
in the way of a "suggested reading". Give me the possibility to
actually find source code examples. For JOSM, the largest project I
manage, you can actually enter parts of the code and most Google links
lead you to relevant pages and source code (and we also have very
little real written documentation).
2) Answer questions in the development group at least with a "read this".
Since I first had contact to Trac development I have the impression, that
you actually don't want to have external developers (the admins know
about the trouble we had until I took over SpamFilter plugin). I can't
understand this, as Trac is really a good product.
Ciao
--
http://www.dstoecker.eu/ (PGP key available)
--
You received this message because you are subscribed to the Google Groups "Trac
Development" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/trac-dev?hl=en.
