<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>As a new Haskell user, I have to heartily agree about the sign-posts. &nbsp;Cabal is a superb, easy-to-use command-line tool for Haskell package management, but browsing various "getting started with Haskell" pages didn't lead me to clear instructions that cabal exists and that it is really important to install.</div><div><br></div><div>In addition, may I suggest that the very first thing under Quick Links at&nbsp;<a href="http://haskell.org/cabal/">http://haskell.org/cabal/</a> should be the following:</div><div><br></div><div><span class="Apple-tab-span" style="white-space:pre">        </span>Get Cabal</div><div><br></div><div>Currently, the first link is "How to install a Cabal package" which was quite confusing for me as a new user, since I knew I wanted the "cabal" command on my system and that getting it is a prerequisite to installing cabal packages.</div><div><br></div><div>Next, in a round-about manner, the link sends the user to&nbsp;<a href="http://haskell.org/haskellwiki/Cabal/How_to_install_a_Cabal_package">http://haskell.org/haskellwiki/Cabal/How_to_install_a_Cabal_package</a> which is fairly dense reading considering that the user is just trying to get cabal. &nbsp;At the bottom of the third paragraph of that page, it links to&nbsp;<a href="http://haskell.org/haskellwiki/Cabal-Install">http://haskell.org/haskellwiki/Cabal-Install</a>. &nbsp;The Cabal-Install page itself provides an introduction paragraph stating that there exists a "caball-install" package which sounds enticing---but wait, is it a package? &nbsp;Doesn't that mean I need cabal to install cabal-install? &nbsp;What's going on here</div><div><br></div><div>Strangely, the "Usage" section is listed before the "Installation" section which further confounded me until I read everything carefully.</div><div><br></div><div>So in retrospect, I would have very much appreciated something like&nbsp;<a href="http://blog.inquirylabs.com/2009/02/28/getting-started-with-haskell-cabal/">this</a>&nbsp;(my blog entry to future Haskellers). &nbsp;Perhaps we could create the "Get Cabal" page and split it down the middle, one side for Windows and one side for Mac OS X / Linux / Unix. &nbsp;It should be very minimal and have all of the necessary steps first with commentary later in case things go wrong or the visitor decides to return for details.</div><div><br></div><div>It also might be a good idea to use the cabal-specific pages on the wiki to redirect the user to the official cabal page where the official instructions reside since they show up in Google searches</div><div><br></div><div>Duane Johnson</div><div><a href="http://blog.inquirylabs.com/">http://blog.inquirylabs.com/</a></div><div><br><div><div>On Mar 21, 2009, at 3:44 PM, Duncan Coutts wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>Hi all,<br><br>I should have done this ages ago but there's now a Cabal FAQ on the<br>Cabal website:<br><br><a href="http://haskell.org/cabal/FAQ.html">http://haskell.org/cabal/FAQ.html</a><br><br>It's not linked in yet, I'm looking for feedback and patches. The Cabal<br>website is now maintained in darcs so it's easy to send in<br>contributions:<br><br>darcs get http://haskell.org/cabal/<br><br>For new pages like the FAQ I've been using markdown via pandoc. If<br>appropriate we can migrate old pages to use that too.<br><br>The main Cabal home page needs some love. We should have the<br>cabal-install download directly on the front page. We should have quick<br>intro tutorials for using the cabal command line program to install<br>packages. There's lots of good material in the user guide but it is not<br>well sign-posted.<br><br>Duncan<br><br>_______________________________________________<br>Haskell-Cafe mailing list<br>Haskell-Cafe@haskell.org<br>http://www.haskell.org/mailman/listinfo/haskell-cafe<br></div></blockquote></div><br></div></body></html>