Re: [Caml-list] Re: LLC book [was: Questions]

2009-04-03 Thread Daniel de Kok
On Thu, Apr 2, 2009 at 8:39 PM, Richard Jones r...@annexia.org wrote:
 Decide on a format: http://en.wikipedia.org/wiki/DocBook - check

I have written one open source book, and participated in another, and
DocBook was always a barrier of entrance for most potential
contributors. These days I'd rather go for something like the asciidoc
format, which can also be converted to DocBook. Having DocBook as an
intermediate format is very handy, because it is so easy to customize
XHTML and XSL-FO output with XSLT.

Take care,
Daniel

___
Caml-list mailing list. Subscription management:
http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
Archives: http://caml.inria.fr
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
Bug reports: http://caml.inria.fr/bin/caml-bugs


Re: [Caml-list] Re: LLC book [was: Questions]

2009-04-03 Thread Daniel de Kok
On Thu, Apr 2, 2009 at 8:39 PM, Richard Jones r...@annexia.org wrote:
 Decide on a format: http://en.wikipedia.org/wiki/DocBook - check

I have written one open source book, and participated in another, and
DocBook was always a barrier of entrance for most potential
contributors. These days I'd rather go for something like the asciidoc
format, which can also be converted to DocBook. Having DocBook as an
intermediate format is very handy, because it is so easy to customize
XHTML and XSL-FO output with XSLT.

Take care,
Daniel

___
Caml-list mailing list. Subscription management:
http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
Archives: http://caml.inria.fr
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
Bug reports: http://caml.inria.fr/bin/caml-bugs


Re: [Caml-list] Re: LLC book [was: Questions]

2009-04-02 Thread Ed Keith

--- On Thu, 4/2/09, Alp Mestan a...@mestan.fr wrote:

 I think it would be a better effort to start a new work, even if harder.
 OCaml's has known some evolutions, there are many key projects (Extlib,  
 Core, Batteries, ...) so it would be nice to throw most of today's OCaml  in 
 an entirely new book. Moreover, there wouldn't be any problem with 
 the publisher of LLC.
 
 
 But for such a project there would be the need for a great team of very  
 motivated people.

First let me say that while I have been a professional programmer for over 
twenty years, have used many languages, and have have been playing with ocaml 
for several years, I am no expert on ocaml (the only language I claim to be 
expert in is C++). Nor do I have much experience writing, and, like many 
Americans, I am monolingual.

Having said that, I currently have some free time time and would be willing to 
offer my assistance to this project. It would give me the opportunity to hone 
my writing and ocaml skills, and I believe as an experienced professional 
programmer (I have worked in government, military, finance, medicine, aviation, 
and research) and ocaml newbie I could bring a useful perspective to the 
project. 

I hope I can be of service,

-EdK

Ed Keith
e_...@yahoo.com

Blog: edkeith.blogspot.com




  

___
Caml-list mailing list. Subscription management:
http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
Archives: http://caml.inria.fr
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
Bug reports: http://caml.inria.fr/bin/caml-bugs


Re: [Caml-list] Re: LLC book [was: Questions]

2009-04-02 Thread Alp Mestan
On Thu, Apr 2, 2009 at 8:39 PM, Richard Jones r...@annexia.org wrote:


 It doesn't take a huge amount to set this up (encouraging people to
 write the words is quite another matter).

 Source control: http://git.ocamlcore.org/ - check

 Decide on a format: http://en.wikipedia.org/wiki/DocBook - check

 License: http://creativecommons.org/ CC-BY-SA - check

 Mailing list for editorial review of submissions:
  http://ocamlcore.org/ - check

 Outline and subject areas:
  - Introduction to the language
  - Language core
  - Libraries
  - Camlp4
  - ...

 Decide who will be in charge of each area ...


And even more important, who would like to participate to this project ? ;-)

-- 
Alp Mestan
___
Caml-list mailing list. Subscription management:
http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
Archives: http://caml.inria.fr
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
Bug reports: http://caml.inria.fr/bin/caml-bugs


Re: [Caml-list] Re: LLC book [was: Questions]

2009-04-02 Thread David Teller
You could start with this: http://fr.wikibooks.org/wiki/Objective_Caml .
I have only had the time to write about 3 chapters (in French) but it
could serve as a base. Oh, and the license and source control are mostly
solved by the use of Wikibooks.

Cheers,
 David


___
Caml-list mailing list. Subscription management:
http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
Archives: http://caml.inria.fr
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
Bug reports: http://caml.inria.fr/bin/caml-bugs