Re: We need "Documentation"
EO> Hi Hal, EO> On Thursday 13 December 2001 20:47, Hal Daume III wrote: >> I think we should move this off the mailing list. I'm willing to >> spear-head such an effort. Anyone who is interested in contributing, >> please email me. I'll compile a list of people and we can figure out >> what we want to do. EO> I think it's okay to discuss in haskell-cafe. Well, original author decided to took discussion off-list ... EO> I'd like to contribute too but I have little time nowadays trying to EO> finish writing my msc. thesis. I do have a few suggestions though: EO> 1. Using wiki does not seem to be a bad idea. You may also consider EO> using a word processing system such as LaTeX though. It's easy to EO> convert LaTeX to html and it yields very quality prints as you all EO> know. However, for true collaboration wiki is the king. There is EO> already a nice Haskell wiki appropriate for such a project IIRC. But Wiki at haskell.org has many limitations :( Does someone know nice Wiki interface which combines Wiki's ease of use and CVS-like revision management and conflict resolution? Most implementations I've seen does not seem to deal well with several ppl editing same page at once - changes often got lost -- Dmitry Astapov //ADEpt E-mail: [EMAIL PROTECTED] GPG KeyID/fprint: F5D7639D/CA36 E6C4 815D 434D 0498 2B08 7867 4860 F5D7 639D ___ Haskell-Cafe mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/haskell-cafe
Re: We need "Documentation"
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi Hal, On Thursday 13 December 2001 20:47, Hal Daume III wrote: > I think we should move this off the mailing list. I'm willing to > spear-head such an effort. Anyone who is interested in contributing, > please email me. I'll compile a list of people and we can figure out what > we want to do. I think it's okay to discuss in haskell-cafe. I'd like to contribute too but I have little time nowadays trying to finish writing my msc. thesis. I do have a few suggestions though: 1. Using wiki does not seem to be a bad idea. You may also consider using a word processing system such as LaTeX though. It's easy to convert LaTeX to html and it yields very quality prints as you all know. However, for true collaboration wiki is the king. There is already a nice Haskell wiki appropriate for such a project IIRC. 2. I don't think following the outline of a class based imperative language will be fitting for a high quality Haskell tutorial. I think you should look at OcaML tutorial and the python tutorial, and combine ideas from both as well as your own :) Thanks, - -- Eray Ozkural (exa) <[EMAIL PROTECTED]> Comp. Sci. Dept., Bilkent University, Ankara www: http://www.cs.bilkent.edu.tr/~erayo GPG public key fingerprint: 360C 852F 88B0 A745 F31B EA0F 7C07 AE16 874D 539C -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.6 (GNU/Linux) Comment: For info see http://www.gnupg.org iD8DBQE8IMf0fAeuFodNU5wRAunNAJ9eS6w6b5ho45htdzDLxhEFhK5EtACgjVdY dP0ObV/+usABuJgRL7aWV9M= =SLzH -END PGP SIGNATURE- ___ Haskell-Cafe mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/haskell-cafe
We need "Documentation" (Was: Re: Integer to String Conversion?)
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Tuesday 04 December 2001 02:51, you wrote: > On Tue, 4 Dec 2001, Chris wrote: > > is there a function that converts Integers to Strings and vice versa? > > Prelude> (reads "123 abc") :: [(Integer, String)] > [(123," abc")] > Prelude> show 123 > "123" > That's the reason why I hadn't been able to join some famous programming contest :) When my brain had already melted I couldn't find how to do this in the documentation for 30 minutes. I had assumed there would have been a specific conversion facility... But I think there are other reasons than my sleepy state at the moment. Why doesn't an author or two who have written Haskell books consider opening their books for public use on the Internet? "The Craft Of ..." especially seems great. I'm sure many coders would appreciate a non-dead-tree version of that book or a shortened version of the book. The material we have is simply lacking. What we need is a good tutorial and a comprehensive reference book. The current state of documentation is far from that. The tutorial should be a tutorial, it should teach all that is needed for basic programming, and probably go beyond that, with examples explained in detail and such. (The tutorial on the web is not like that). The reference manual again must go ahead with examples, and a logical organization of programming concepts and language features. Otherwise Haskell is never going to find too much appeal in application programming; it will remain in obscurity in research centers and extreme hacker quarters. For coders who have not written papers about Haskell, the documentation is maximally cryptic. I could find only a single decent book in our university's library, it was a functional algorithms book that gave examples in Haskell. Without that book, I could never have written the code I wrote within a small amount of time. There was the Miranda version of "The Craft Of..", but I didn't want to do too much guessing. So basically, I was left with that book which had an introductory chapter (I don't remember the exact name of the book) to Haskell and the online docs. The tutorial chapter of the book, which was an algorithms book, turned out to be much better than what the online docs had to offer although its purpose was to teach only a small subset of the language for algorithm design. Thanks, - -- Eray Ozkural (exa) <[EMAIL PROTECTED]> Comp. Sci. Dept., Bilkent University, Ankara www: http://www.cs.bilkent.edu.tr/~erayo GPG public key fingerprint: 360C 852F 88B0 A745 F31B EA0F 7C07 AE16 874D 539C -BEGIN PGP SIGNATURE- Version: GnuPG v1.0.6 (GNU/Linux) Comment: For info see http://www.gnupg.org iD8DBQE8DJR0fAeuFodNU5wRAmksAJ4jUaj3zXZxzSFTnd06LTMk+E2TdACfVwBS gwjbfyAbMs/VkSIQEChpw2I= =+YDW -END PGP SIGNATURE- ___ Haskell-Cafe mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/haskell-cafe