Vincent, Never even knew that existed. It is a big problem with just slapping commenting ability to docs. If its not being used its because there isn't incentive for it. When you see the entire documentation blank of comments would you be so inclined to add it? Documentation is so important and as few barriers should be present to let people contribute. Even more so when you give those powers to the public there still needs to be a much larger drive to those running it to do much of the work up front. They should be putting the comments up in the first place.
Another issue is you need to monitor freshness. I.E http://www.freepascal.org/contrib/db.php3?category=File%20Handling The lot of units in there are broken links, no order of naming, and just all together badly organized. This is in no way FPCs fault, they make the compiler, a damn good one at that, but the comminuty behind this is lack luster. Seems like the FPC team is trying to centralize everything on their ends but doesn't have the resources. Although this is a big rant on my part I will be more then happy to help with anything. On Thu, Apr 22, 2010 at 2:52 PM, Vincent Snijders <vsnijd...@vodafonevast.nl> wrote: > Joseph Montanez schreef: >> >> <rant> >> >> In the end I think automated documentation is bad, and thats really >> what I see with the current state of FPC docs. It might allow better >> ability to stay sync with the current release but not allowing _easy_ >> social interaction to expand those docs, I think it is a big mistake. >> </rant> > > Is this in response to removing the direct link to unit reference docs with > comments at http://www.hu.freepascal.org:10000, that was not really used? > > Vincent > > _______________________________________________ > fpc-pascal maillist - fpc-pas...@lists.freepascal.org > http://lists.freepascal.org/mailman/listinfo/fpc-pascal > -- Joseph Montanez Web Developer Gorilla3D Design, Develop, Deploy _______________________________________________ fpc-pascal maillist - fpc-pascal@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-pascal
