From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Original-To: caml-list@sympa.inria.fr Delivered-To: caml-list@sympa.inria.fr Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105]) by sympa.inria.fr (Postfix) with ESMTPS id EE3EC7F2AA for ; Fri, 21 Dec 2012 14:05:44 +0100 (CET) Received-SPF: None (mail4-smtp-sop.national.inria.fr: no sender authenticity information available from domain of wojciech.meyer@gmail.com) identity=pra; client-ip=209.85.215.46; receiver=mail4-smtp-sop.national.inria.fr; envelope-from="wojciech.meyer@gmail.com"; x-sender="wojciech.meyer@gmail.com"; x-conformance=sidf_compatible Received-SPF: Pass (mail4-smtp-sop.national.inria.fr: domain of wojciech.meyer@gmail.com designates 209.85.215.46 as permitted sender) identity=mailfrom; client-ip=209.85.215.46; receiver=mail4-smtp-sop.national.inria.fr; envelope-from="wojciech.meyer@gmail.com"; x-sender="wojciech.meyer@gmail.com"; x-conformance=sidf_compatible; x-record-type="v=spf1" Received-SPF: None (mail4-smtp-sop.national.inria.fr: no sender authenticity information available from domain of postmaster@mail-la0-f46.google.com) identity=helo; client-ip=209.85.215.46; receiver=mail4-smtp-sop.national.inria.fr; envelope-from="wojciech.meyer@gmail.com"; x-sender="postmaster@mail-la0-f46.google.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjwBAHld1FDRVdcujWdsb2JhbABFvXAIFg4BAQEBCQkLCRIGI4IeAQEEAUABGx4DDAYFCw0uIQEBEQEFARwGARIUh2wBAwkGlzuMM4J7hRsKGScNWYh2AQUMi2FqhEMDlDWBVoEcihuDMRYphBU X-IronPort-AV: E=Sophos;i="4.84,329,1355094000"; d="scan'208";a="166536043" Received: from mail-la0-f46.google.com ([209.85.215.46]) by mail4-smtp-sop.national.inria.fr with ESMTP/TLS/RC4-SHA; 21 Dec 2012 14:05:44 +0100 Received: by mail-la0-f46.google.com with SMTP id p5so5025306lag.19 for ; Fri, 21 Dec 2012 05:05:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=pxv7mE5jg4L5a1jAqrNqsVkB5H35jaemoNkSiy10nBc=; b=tCDQhmiRPN9hrAeM0IdYCo4xkFoAvHsC6bKMfr0DoLTDSmqdB17GnE/Fk3KNTe2Yyh 1cWkJDye42Juhj21mWOjQ0JAVeMcMFU13zfjJM/p/kyofi3cS5FHaDWndL+Ryr1Ay6pm kmPnBaH/Z3W6JtZLafoe712/L/GIY/Z9YKjQbK9OP2Gx9rS712F/LinDvbzOZsRueqgF aPT4YgpCtRVQQWSVXE6v12kUVSD/hpAI2gbj6hwGV/XuOgVfdUMMXbWV7De7VtFm4xeW 2jiN6KrI9n8zQi/g9ToLrQNHuhIviefxXId29BWRDw4Yz+lcUvUpnJ0fRdCNGqoHFWUP 3DWg== MIME-Version: 1.0 Received: by 10.152.147.103 with SMTP id tj7mr12352410lab.54.1356095143718; Fri, 21 Dec 2012 05:05:43 -0800 (PST) Received: by 10.114.37.73 with HTTP; Fri, 21 Dec 2012 05:05:43 -0800 (PST) In-Reply-To: References: <6A2113E2-2202-46EA-B0B0-7C80AA25B480@recoil.org> <88F05F0A-10A2-47AF-8285-575E95797E54@recoil.org> Date: Fri, 21 Dec 2012 13:05:43 +0000 Message-ID: From: Wojciech Meyer To: Ashish Agarwal , Caml List Content-Type: text/plain; charset=ISO-8859-1 Subject: Re: [Caml-list] OCaml wiki Hi Ashish, On Fri, Dec 21, 2012 at 2:49 AM, Ashish Agarwal wrote: > A wiki could be good but I strongly encourage any such effort to integrate > with ocaml.org, and to carefully weigh the pros and cons. Wikis make > contributions easier, but you need someone to keep the content organized and > do some basic quality control. Also, the structure of the documentation is > not very customizable. The question is whether pushing to a git repo (the > current contribution method for ocaml.org) is so much harder (given that > we're all programmers after all). yes, the intention is always go integrate with ocaml.org. Maybe we can sort out the problem of submitting changes programaticaly, i.e. repo with tools that simplify the whole process. The bottleneck I see that the changes needs to be "formally approved" - the git repo merged, where it takes a bit more time and shifts the responsibiltiy to another person. I can see advantage of that but then doing small changes is more difficult. > > The tutorials page is a good candidate for converting to wiki format, but > remember that a wiki is where all this content came from, and it eventually > got out of date. We could create wiki.ocaml.org, but then the question is > how to make it integrate nicely with the rest of the pages that don't fit > the wiki model. the same theme and nice search box would be enough? > > Finally, which wiki software to use? None are very good, and who amongst us > is keen to hack into php code. My initial goal for ocaml.org was to use > ocsigen and ocsimore, but there is a big upfront cost in getting such a site > implemented. My answer would be as lightweight as possible, oddmuse is perl, mediawiki is php. Also these are wiki engines, so we probably don't need to hack on it. They are fairly robust too. So no need to worry that we need to get dirty with php :) I also think ocsigen with ocsimore would be cool to have at some point, it's a big deal for any language to have self hosting webserver with dynamic pages. > > Whatever the community decides, we can support and integrate with ocaml.org. > My only strong opinion is please don't build a separate unrelated site, with > duplication of effort and and fragmentation of content. We could have at least a static webpage generator like Stog, and keep the content in the markup that can be pushed to ocaml.org. It would be then easier to write any content and diff it. Thanks, -Wojciech