[fpc-devel] [RFC] fpdoc output comment from the source

[Michael Van Canneyt]

On Fri, 16 Dec 2005, L505 wrote:

>
>
>>> Did you miss something?
>>
>>> On the FPC homepage:
>>> - Click "on-line documentation"
>>> - Click "documentation table of contents with comments"
>>> - Click "Add a comment"
>>
>
> I think I finally figured out your little comment system for the units generated with
> FPDOC that I seemed to magically find today:
>
> http://community.freepascal.org:10000/docs-html/rtl/index.html
>
> The comment system *is* (and has been, for how long I don't know) in place - even if
> it took me 50 years to find. The major problem is no one reads those documents, or
> can find them easily.  People read what is indexed by google:
> http://www.freepascal.org/docs-html/rtl/
>
> I think the reason I've never landed on a comment document page is because google
> treats them as duplicates and doesn't index them. That, and as I said before, the
> fact that we have so many FPC mirrors out there with the exact same content makes
> google think there is no need to index the documents with comments.
>
> I'd force the comments onto people - they can't do any harm. Why offer the docs
> without comments? It'd be better for google, but not necessarily better for those
> people who don't like comments under the documents (who wouldn't?).

The author, for one :-)

The commenting system puts extra load on the server which I don't want.

Michael.