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 mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82]) by sympa.inria.fr (Postfix) with ESMTPS id 480627F2AA for ; Fri, 21 Dec 2012 00:49:57 +0100 (CET) Received-SPF: None (mail1-smtp-roc.national.inria.fr: no sender authenticity information available from domain of wojciech.meyer@gmail.com) identity=pra; client-ip=74.125.82.174; receiver=mail1-smtp-roc.national.inria.fr; envelope-from="wojciech.meyer@gmail.com"; x-sender="wojciech.meyer@gmail.com"; x-conformance=sidf_compatible Received-SPF: Pass (mail1-smtp-roc.national.inria.fr: domain of wojciech.meyer@gmail.com designates 74.125.82.174 as permitted sender) identity=mailfrom; client-ip=74.125.82.174; receiver=mail1-smtp-roc.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 (mail1-smtp-roc.national.inria.fr: no sender authenticity information available from domain of postmaster@mail-we0-f174.google.com) identity=helo; client-ip=74.125.82.174; receiver=mail1-smtp-roc.national.inria.fr; envelope-from="wojciech.meyer@gmail.com"; x-sender="postmaster@mail-we0-f174.google.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AkwCACqj01BKfVKujWdsb2JhbABFg0i6KBYOAQEBAQkJCwkSBiOCHgEBBAFAARsdAQMBCwYFCw0JJQ8BBA8RAQUBIhOIAAEDCQYEmUeMM4J7hRkKGScNWYh2AQUMi2FqhEMDlguBHI1MP4QV X-IronPort-AV: E=Sophos;i="4.84,326,1355094000"; d="scan'208";a="187127836" Received: from mail-we0-f174.google.com ([74.125.82.174]) by mail1-smtp-roc.national.inria.fr with ESMTP/TLS/RC4-SHA; 21 Dec 2012 00:49:56 +0100 Received: by mail-we0-f174.google.com with SMTP id x10so1847699wey.5 for ; Thu, 20 Dec 2012 15:49:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-type; bh=PLceY3ag5ClwTJ1MhBwpTW445gV0LtX7pVAbL4dzeh0=; b=SXePkLUyQQ5YsaLUFmmsSoj4j9zYX/VmwnaUuK/MTX9khqrRayUFFfN5deXsZolLYE mYz1MrxSjsaee/EP1Ehi88In70geh8v7cpgNqNnZhXA9UBKh3WtO7/THy9jfnWDEJRnx iaWMDc4YG7To9MDQmubHZ+76ck9cAbC9xjBSVqMN62YCdi0s62pHdXkq0qNCIHMizXEn HnE2syDxj2yr2ywHQFwMqkiffVWpONAbH2FHc0YEie1b4FjOEdQsNYBF6djF0h0mbjqt w0pOqpC5iSjsJbwUJ+Nhh51t5IUrsHSZsE228DNcN8wVCUEZIAHGGMTmgQnXkgSHLUvT Zfrg== X-Received: by 10.180.20.177 with SMTP id o17mr12521186wie.24.1356047396606; Thu, 20 Dec 2012 15:49:56 -0800 (PST) Received: from spec-desktop.danmey.org (cpc1-cmbg12-0-0-cust201.5-4.cable.virginmedia.com. [86.9.116.202]) by mx.google.com with ESMTPS id hg17sm27473599wib.1.2012.12.20.15.49.55 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 20 Dec 2012 15:49:56 -0800 (PST) From: Wojciech Meyer To: Anil Madhavapeddy Cc: Benedikt Meurer , caml-list@inria.fr References: <6A2113E2-2202-46EA-B0B0-7C80AA25B480@recoil.org> <88F05F0A-10A2-47AF-8285-575E95797E54@recoil.org> Date: Thu, 20 Dec 2012 23:50:08 +0000 In-Reply-To: <88F05F0A-10A2-47AF-8285-575E95797E54@recoil.org> (Anil Madhavapeddy's message of "Thu, 20 Dec 2012 23:34:18 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.94 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain Subject: Re: [Caml-list] OCaml wiki Anil Madhavapeddy writes: > On 20 Dec 2012, at 23:31, Benedikt Meurer wrote: >> >> On Dec 21, 2012, at 0:22 , Anil Madhavapeddy 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