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 A22327F2AA for ; Fri, 21 Dec 2012 10:40:05 +0100 (CET) Received-SPF: None (mail4-smtp-sop.national.inria.fr: no sender authenticity information available from domain of philippe.veber@gmail.com) identity=pra; client-ip=209.85.223.172; receiver=mail4-smtp-sop.national.inria.fr; envelope-from="philippe.veber@gmail.com"; x-sender="philippe.veber@gmail.com"; x-conformance=sidf_compatible Received-SPF: Pass (mail4-smtp-sop.national.inria.fr: domain of philippe.veber@gmail.com designates 209.85.223.172 as permitted sender) identity=mailfrom; client-ip=209.85.223.172; receiver=mail4-smtp-sop.national.inria.fr; envelope-from="philippe.veber@gmail.com"; x-sender="philippe.veber@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-ie0-f172.google.com) identity=helo; client-ip=209.85.223.172; receiver=mail4-smtp-sop.national.inria.fr; envelope-from="philippe.veber@gmail.com"; x-sender="postmaster@mail-ie0-f172.google.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AnsBAPMt1FDRVd+sm2dsb2JhbABFqyYziQsBiQkIFg4BAQEBAQgJCwkUJ4IeAQEEAUABGxICCQEDAQsGBQsNDRoHIQEBEQEFAQoBEQYTCQkCh2wBAwkGDJdLjDOCe4UZChknAwpZiHYBBQyLYWoVB4QnA5Q1gVaBHIobAoMvFimCUIFGgWM X-IronPort-AV: E=Sophos;i="4.84,329,1355094000"; d="scan'208";a="166509316" Received: from mail-ie0-f172.google.com ([209.85.223.172]) by mail4-smtp-sop.national.inria.fr with ESMTP/TLS/RC4-SHA; 21 Dec 2012 10:40:03 +0100 Received: by mail-ie0-f172.google.com with SMTP id c13so5849221ieb.17 for ; Fri, 21 Dec 2012 01:40:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=VuC35a4fkQl4KNrVkTl3UEwOhWUcU4UIXHw2mVW3614=; b=ia6PQ4KUHMJbCLmk5jPLevHrnBOj+Zz/nVarrApzIDAYpJP8i3jTGniFSuZdECLLn5 6WiBJAKjv6skakA46jcAeNl8GyQiYFjDNopQekb+P003JPGpXsL0pMYd4JPVXh6mIKTP 278AdfnczeJpCIqajtyqw4gxDNvqfpzbUquxidz0aSYyKJlegHKJ+2rhOHqfSuoxebAe 9ZMWO7+VaSEsxXuKMNOWbzpswPOdIsR+yYqzuFgFRVeip31GotcsGPkHminPbtC5LaB9 Pv9/ZYlV3JjL8RLQ926HAuYE6Q2ORA6hQ7Kc8Ojd7FsOW1SS4tZp7fBIjCU3HEsbm+0q UzgQ== Received: by 10.50.170.66 with SMTP id ak2mr13346205igc.38.1356082801357; Fri, 21 Dec 2012 01:40:01 -0800 (PST) MIME-Version: 1.0 Received: by 10.64.6.226 with HTTP; Fri, 21 Dec 2012 01:39:41 -0800 (PST) In-Reply-To: <50D42855.4050609@fastmail.fm> References: <6A2113E2-2202-46EA-B0B0-7C80AA25B480@recoil.org> <88F05F0A-10A2-47AF-8285-575E95797E54@recoil.org> <50D42855.4050609@fastmail.fm> From: Philippe Veber Date: Fri, 21 Dec 2012 10:39:41 +0100 Message-ID: To: Fermin Reig Cc: Ashish Agarwal , Wojciech Meyer , Anil Madhavapeddy , Benedikt Meurer , caml-list@inria.fr Content-Type: multipart/alternative; boundary=e89a8f2351a9a932ed04d159a1d2 X-Validation-by: philippe.veber@gmail.com Subject: Re: [Caml-list] OCaml wiki --e89a8f2351a9a932ed04d159a1d2 Content-Type: text/plain; charset=ISO-8859-1 Of course you can do good stuff with a wiki! I was not arguing that a wiki is not an adequate medium to build a website, but rather that we should not duplicate our efforts. I think building a site of good quality and well organised is a lot of work *whatever* the technology you're relying on (not to mention, the time to get it accepted) The site ocaml.org is built with templated HTML and stored on github, this is one possible technical choice where contributions are easy to make if the procedure is documented properly. Right now I see no compelling argument to start a wiki, and just argued that we should first focus on the website. Maybe after some time (and hopefully many contributions :o)!), it will become evident that we need something else (maybe a wiki), but right now I find it risky to split our efforts in several community projects. Sorry if my previous message was not clear, and thanks for the pointer to the guidelines! 2012/12/21 Fermin Reig > For what it's worth, haskell.org is a wiki and the contents is of good > quality and well organised. Guidelines for contributing are available at > http://www.haskell.org/**haskellwiki/HaskellWiki:**Contributing > > On 21/12/12 08:37, Philippe Veber wrote: > >> For what it's worth, my opinion is also that we should focus our efforts >> on the website, especially now that we have something that we can be proud >> of (kudos to all those behind ocaml.org ). As the >> development of the website showed very well, it takes a really high amount >> of time and tenacious work to do something useful *and* acknowledged. I >> think there is a limited man-power in the community to advertise and >> document our favorite language, let's not split it up but rather pour it >> into a single, high-quality and carefully reviewed contents. I feel the >> best achievement of ocaml.org is to exist as a >> central place where to add ocaml material, improving the readability of >> ocaml as a whole, and the visibility of ocaml projects. Pushing to a git >> repo is more difficult than adding stuff on a wiki, but we nerds don't >> really care about that, right ;o)? >> >> So yes, the only benefit I see for the wiki is to lower the barrier for >> contributions. It is true (I tried this morning) that it is not >> straightforward to contribute to the site for those who do not use opam and >> git everyday (not to mention that you have to know HTML basics). But with a >> proper documentation, using git to contribute the website is not so >> difficult, and has lots of (editorial) benefits. Plus that way we help >> people to learn those anyway useful technologies. Unless someone wants to >> write it, I can have a try at writing a page "Contributing to ocaml.org < >> http://ocaml.org>" (I couldn't see such a page on the website). >> >> >> >> 2012/12/21 Ashish Agarwal > agarwal1975@gmail.com>**> >> >> >> 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). >> >> 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. >> >> 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. >> >> 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. >> >> >> On Thu, Dec 20, 2012 at 6:50 PM, Wojciech Meyer >> >> >> wrote: >> >> 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 >> >> -- >> Caml-list mailing list. Subscription management and archives: >> https://sympa.inria.fr/sympa/**arc/caml-list >> Beginner's list: http://groups.yahoo.com/group/**ocaml_beginners >> Bug reports: http://caml.inria.fr/bin/caml-**bugs >> >> >> >> > --e89a8f2351a9a932ed04d159a1d2 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Of course you can do good stuff with a wiki! I was not arguing that a wiki = is not an adequate medium to build a website, but rather that we should not= duplicate our efforts. I think building a site of good quality and well or= ganised is a lot of work *whatever* the technology you're relying on (n= ot to mention, the time to get it accepted) The site ocaml.org is built with templated HTML and stored on github, thi= s is one possible technical choice where contributions are easy to make if = the procedure is documented properly. Right now I see no compelling argumen= t to start a wiki, and just argued that we should first focus on the websit= e. Maybe after some time (and hopefully many contributions :o)!), it will b= ecome evident that we need something else (maybe a wiki), but right now I f= ind it risky to split our efforts in several community projects. Sorry if m= y previous message was not clear, and thanks for the pointer to the guideli= nes!

2012/12/21 Fermin Reig <= ;ferminreig@fas= tmail.fm>
For what it's worth, h= askell.org is a wiki and the contents is of good quality and well organ= ised. Guidelines for contributing are available at http://ww= w.haskell.org/haskellwiki/HaskellWiki:Contributing

On 21/12/12 08:37, Philippe Veber wrote:
For what it's worth, my opinion is also that we should focus our effort= s on the website, especially now that we have something that we can be prou= d of (kudos to all those behind ocaml.org <http:/= /ocaml.org>). As the development of the website showed very well, it= takes a really high amount of time and tenacious work to do something usef= ul *and* acknowledged. I think there is a limited man-power in the communit= y to advertise and document our favorite language, let's not split it u= p but rather pour it into a single, high-quality and carefully reviewed con= tents. I feel the best achievement of ocaml.org <http://ocaml.org> is to exist as a central place where to add ocam= l material, improving the readability of ocaml as a whole, and the visibili= ty of ocaml projects. Pushing to a git repo is more difficult than adding s= tuff on a wiki, but we nerds don't really care about that, right ;o)?
So yes, the only benefit I see for the wiki is to lower the barrier for con= tributions. It is true (I tried this morning) that it is not straightforwar= d to contribute to the site for those who do not use opam and git everyday = (not to mention that you have to know HTML basics). But with a proper docum= entation, using git to contribute the website is not so difficult, and has = lots of (editorial) benefits. Plus that way we help people to learn those a= nyway useful technologies. Unless someone wants to write it, I can have a t= ry at writing a page "Contributing to ocaml.org <http://ocaml.org>" (I couldn't see such a page on the = website).



2012/12/21 Ashish Agarwal <agarwal1975@gmail.com <mailto:agarwal1975@gmail.com>>=


=A0 =A0 A wiki could be good but I strongly encourage any such effort to
=A0 =A0 integrate with ocaml= .org <http://ocaml.or= g>, and to carefully

=A0 =A0 weigh the pros and cons. Wikis make contributions easier, but you =A0 =A0 need someone to keep the content organized and do some basic
=A0 =A0 quality control. Also, the structure of the documentation is not
=A0 =A0 very customizable. The question is whether pushing to a git repo
=A0 =A0 (the current contribution method for ocaml.org <http://ocaml.org>)

=A0 =A0 is so much harder (given that we're all programmers after all).=

=A0 =A0 The tutorials page is a good candidate for converting to wiki
=A0 =A0 format, but remember that a wiki is where all this content came
=A0 =A0 from, and it eventually got out of date. We could create
=A0 =A0 wiki.ocaml.org<= /a> <http://wiki.oca= ml.org>, but then the question is

=A0 =A0 how to make it integrate nicely with the rest of the pages that
=A0 =A0 don't fit the wiki model.

=A0 =A0 Finally, which wiki software to use? None are very good, and who
=A0 =A0 amongst us is keen to hack into php code. My initial goal for
=A0 =A0 ocaml.org <http://ocaml.org> was t= o use ocsigen and ocsimore, but

=A0 =A0 there is a big upfront cost in getting such a site implemented.

=A0 =A0 Whatever the community decides, we can support and integrate with
=A0 =A0 ocaml.org <http://ocaml.org>. My o= nly strong opinion is please

=A0 =A0 don't build a separate unrelated site, with duplication of effo= rt
=A0 =A0 and and fragmentation of content.


=A0 =A0 On Thu, Dec 20, 2012 at 6:50 PM, Wojciech Meyer
=A0 =A0 <w= ojciech.meyer@gmail.com <mailto:wojciech.meyer@gmail.com>> wrote= :

=A0 =A0 =A0 =A0 Anil Madhavapeddy <anil@recoil.org <mailto:anil@recoil.org>>

=A0 =A0 =A0 =A0 writes:

=A0 =A0 =A0 =A0 > On 20 Dec 2012, at 23:31, Benedikt Meurer
=A0 =A0 =A0 =A0 <benedikt.meurer@googlemail.com
=A0 =A0 =A0 =A0 <mailto:benedikt.meurer@googlemail.com>> wrote= :
=A0 =A0 =A0 =A0 >>
=A0 =A0 =A0 =A0 >> On Dec 21, 2012, at 0:22 , Anil Madhavapeddy
=A0 =A0 =A0 =A0 <an= il@recoil.org <mailto:anil@recoil.org>> wrote:
=A0 =A0 =A0 =A0 >>
=A0 =A0 =A0 =A0 >>> Personally, I've got mixed feelings about = wikis from
=A0 =A0 =A0 =A0 experience with
=A0 =A0 =A0 =A0 >>> previous projects, since they get out of date = very rapidly
=A0 =A0 =A0 =A0 indeed. They
=A0 =A0 =A0 =A0 >>> do work well if someone's maintaining it, = but if that's
=A0 =A0 =A0 =A0 the case, why
=A0 =A0 =A0 =A0 >>> not just push these tips and guides to the exi= sting
=A0 =A0 =A0 =A0 ocaml.org <http://ocaml.org&g= t; site?

=A0 =A0 =A0 =A0 >>>
=A0 =A0 =A0 =A0 >>> I'm happy to run a wiki on the OCL infrast= ructure, but
=A0 =A0 =A0 =A0 would strongly
=A0 =A0 =A0 =A0 >>> prefer contributions to the ocaml.org <http://ocaml.org>

=A0 =A0 =A0 =A0 Git repo with all this good stuff
=A0 =A0 =A0 =A0 >>> instead! =A0If it really turns out we need a s= wanky wiki,
=A0 =A0 =A0 =A0 that can be arranged
=A0 =A0 =A0 =A0 >>> later...
=A0 =A0 =A0 =A0 >>
=A0 =A0 =A0 =A0 >> Why not use the wiki provided by Github for the ocaml.org
=A0 =A0 =A0 =A0 <http://o= caml.org> project?

=A0 =A0 =A0 =A0 >
=A0 =A0 =A0 =A0 > That works too; Thomas has written a Github Markdown t= o HTML
=A0 =A0 =A0 =A0 converter in
=A0 =A0 =A0 =A0 > COW [1], and is using that to generate the OPAM websit= e from
=A0 =A0 =A0 =A0 the Github
=A0 =A0 =A0 =A0 > wiki (for the documentation that you see on
=A0 =A0 =A0 =A0 opam= .ocamlpro.com <http://opam.ocamlpro.com>).


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

=A0 =A0 =A0 =A0 As for protecting the wiki from being up-date emacswiki [1]= is
=A0 =A0 =A0 =A0 always a
=A0 =A0 =A0 =A0 great example that it is possible as long as people maintai= n their
=A0 =A0 =A0 =A0 webpages. Also, I feel that ocaml.org <http://ocaml.org> pages

=A0 =A0 =A0 =A0 on github would be a good
=A0 =A0 =A0 =A0 entry point.

=A0 =A0 =A0 =A0 [1] htt= p://emacswiki.org/

=A0 =A0 =A0 =A0 -Wojciech

=A0 =A0 =A0 =A0 --
=A0 =A0 =A0 =A0 Caml-list mailing list. =A0Subscription management and arch= ives:
=A0 =A0 =A0 =A0 https://sympa.inria.fr/sympa/arc/caml-list
=A0 =A0 =A0 =A0 Beginner's list: http://groups.yahoo.com/group/= ocaml_beginners
=A0 =A0 =A0 =A0 Bug reports: http://caml.inria.fr/bin/caml-bugs





--e89a8f2351a9a932ed04d159a1d2--