Re: [Caml-list] OCaml wiki

[Wojciech Meyer <wojciech.meyer@gmail.com>]

Anil Madhavapeddy <anil@recoil.org> writes:

> On 20 Dec 2012, at 23:31, Benedikt Meurer <benedikt.meurer@googlemail.com> wrote:
>>
>> On Dec 21, 2012, at 0:22 , Anil Madhavapeddy <anil@recoil.org> wrote:
>>
>>> Personally, I've got mixed feelings about wikis from experience with
>>> previous projects, since they get out of date very rapidly indeed. They
>>> do work well if someone's maintaining it, but if that's the case, why
>>> not just push these tips and guides to the existing ocaml.org site?
>>>
>>> I'm happy to run a wiki on the OCL infrastructure, but would strongly
>>> prefer contributions to the ocaml.org Git repo with all this good stuff
>>> instead!  If it really turns out we need a swanky wiki, that can be arranged
>>> later...
>>
>> Why not use the wiki provided by Github for the ocaml.org project?
>
> That works too; Thomas has written a Github Markdown to HTML converter in
> COW [1], and is using that to generate the OPAM website from the Github
> wiki (for the documentation that you see on opam.ocamlpro.com).

Yes, we could use github pages as long as they are searchable, I see no
problem with it. I think the biggest advantage of wiki would be that
everything would be in single place and hyperlinked.

As for protecting the wiki from being up-date emacswiki [1] is always a
great example that it is possible as long as people maintain their
webpages. Also, I feel that ocaml.org pages on github would be a good
entry point.

[1] http://emacswiki.org/

-Wojciech