Re: [Chicken-hackers] Distributed egg repo proposal

[John Gabriele]

On Tue, Mar 15, 2011 at 1:17 AM, Felix
<address@hidden> wrote:
>> [^1]: Incidentally, the [Pandoc](http://johnmacfarlane.net/pandoc/)
>> tool works well for converting various input doc formats to various
>> output doc formats (including html).
>
> We should make sure not to depend on any external tools. Everything
> breaks, sooner or later, and we must be able to fix it.

My point was that, if you tell prospective egg contributors that they
can optionally supply their own html docs, they can use whatever tools
they want to generate that html (even write it by-hand, if they like).
Perhaps I shouldn't have mentioned Pandoc as a specific example tool.
There seem to be some other options listed at
http://wiki.call-cc.org/chicken-projects/egg-index-4.html#doc-tools .

The implication being, if they don't want to document their package in
the wiki (perhaps because they've already written their docs in some
other format), you could offer them the option of just providing their
own raw html and you could install it and host it for them at
something like http://eggdocs.call-cc.org/package-name .

---John