[reportlab-users] Bulleted Text not displaying
andy at reportlab.com
Tue Oct 14 02:24:00 EDT 2008
2008/10/13 Peter Mattingly <pmattingly at mail.csuchico.edu>:
> You know what I mean though? Sufficient technical documentation is one huge
> hurdle that OSS in general has to get over before any sort of general (read:
> Non-maddeningly frustrating) adoption can take place.
You're correct; it is a weakness. (But i our favour, we do have a
broadly accurate user
guide, the source to create it, and a ton of readable, working tests).
But it also
takes a heck of a lot of time - more than maintaining
the code does. It's not just documenting new features, it's constantly
pruning and editing everything which may be affected by a change. The only
workable solution is a community effort, which I have been pleading for on this
list for years.
> And...you can patch the docs? First I've heard of doing that...
The source to the docs has been in every distro since launch until,
oh, about 3 weeks ago (you have to use svn now). They are just Python
scripts. This was our criterion for release 1.
If someone finds that the user guide doesn't explain something clearly enough,
and has an hour to spare, it would be great if they could either (a) send
in a patch correcting or expanding it (i.e. 20 lines to generate the right
paragraphs in the guide); or (b) send in a test script or teaching example.
We can review and check these things quickly.
ReportLab Europe Ltd.
165 The Broadway, Wimbledon, London SW19 1NE, UK
More information about the reportlab-users