
Hi, The hackage web page confuses me: http://hackage.haskell.org/packages/hackage.html As a user, when I go to that page, I would be seeking one of four pieces of information: 1) How to install a cabal package 2) How to create and upload a cabal package 3) What packages are on hackage 4) What is hackage The first paragraph answers question 4, before pointing off at the trac pages, which contain similar and overlapping information, as well as completely other stuff. The second paragraph basically answers 3 and 1, but in rather roundabout ways, not including a link to the answer to 3, but including a link about CabalInstall which you can't use yet. The rest of the page is notes for the hackage developers. I just went to hackage looking for the answer to question 2. I can't find it. I have a rough idea where some of the information might be hiding, but we really need a walkthrough tutorial - and I'm sure I've seen one of these before. I would think something more like the style of this might work better: http://www-users.york.ac.uk/~socs235/welcome.htm Hackage has now graduated from being a nice idea to being a critial user-focused thingy, which is great. Perhaps the website needs a little bit of thought along those lines. This isn't intended to be a complaint at all - just a new perspective to the people who develop it and probably don't read the web page at all. Thanks Neil

Hello Neil, Wednesday, January 2, 2008, 7:30:21 PM, you wrote:
The hackage web page confuses me: http://hackage.haskell.org/packages/hackage.html
btw, i very like idea of using wiki pages which allows all users to participate in development of docs. may be it will be better to wikify this page too -- Best regards, Bulat mailto:Bulat.Ziganshin@gmail.com

In message <404396ef0801020830t7a6f8bc3ydf01ca829a2af778@mail.gmail.com> "Neil
Mitchell"
Hi,
The hackage web page confuses me: http://hackage.haskell.org/packages/hackage.html
Hackage has now graduated from being a nice idea to being a critial user-focused thingy, which is great. Perhaps the website needs a little bit of thought along those lines. This isn't intended to be a complaint at all - just a new perspective to the people who develop it and probably don't read the web page at all.
You're quite right. We'd welcome a rewrite. You or anyone else is most welcome to send us a new version in .html or any other format. If there are no immediate volunteers then someone should file a bug against the HackageDB component in our tracker so we do not forget. http://hackage.haskell.org/trac/hackage Duncan

On 2008.01.02 17:20:04 +0000, Duncan Coutts
In message <404396ef0801020830t7a6f8bc3ydf01ca829a2af778@mail.gmail.com> "Neil Mitchell"
writes: Hi,
The hackage web page confuses me: http://hackage.haskell.org/packages/hackage.html
Hackage has now graduated from being a nice idea to being a critial user-focused thingy, which is great. Perhaps the website needs a little bit of thought along those lines. This isn't intended to be a complaint at all - just a new perspective to the people who develop it and probably don't read the web page at all.
You're quite right. We'd welcome a rewrite. You or anyone else is most welcome to send us a new version in .html or any other format.
If there are no immediate volunteers then someone should file a bug against the HackageDB component in our tracker so we do not forget. http://hackage.haskell.org/trac/hackage
Duncan
Is there any Darcs repo for the Hackage HTML, or does it just sort of exist by itself on the servers? -- gwern Ridge 9705 Rubin WID Venezuela Analyzer NAIAG naphthalene Privacy AGT.

On Fri, 2008-01-04 at 17:53 -0500, gwern0@gmail.com wrote:
On 2008.01.02 17:20:04 +0000, Duncan Coutts
scribbled 0.8K characters:
You're quite right. We'd welcome a rewrite. You or anyone else is most welcome to send us a new version in .html or any other format.
If there are no immediate volunteers then someone should file a bug against the HackageDB component in our tracker so we do not forget. http://hackage.haskell.org/trac/hackage
Duncan
Is there any Darcs repo for the Hackage HTML, or does it just sort of exist by itself on the servers?
Seems not, though perhaps Ross might correct me. It would indeed be an improvement. Duncan
participants (4)
-
Bulat Ziganshin
-
Duncan Coutts
-
gwern0@gmail.com
-
Neil Mitchell