top | item 775759

A new Erlang docs repository

123 points| gruseom | 16 years ago |erldocs.com | reply

10 comments

order
[+] daleharvey|16 years ago|reply
heh, author here, I was going to wait a while to submit this, its a little bit messy right now and theres quite a few things that need worked on, but I wanted to get it up sooner rather than later.

Ive got a lot of ideas for what to do with this, but any suggestions / feedback / examples I would be happy to hear.

some goals

  * Fix bugs, few problems with the html being rendered etc
  * Clean up layout, its rather ugly right now
  * Add other documentation types (user guides etc), and link to other 
    good sites http://learnyousomeerlang.com/ etc
  * Make googleable very important
  * User comments, ala php docs 
  * Make it easy to include documentation for 3rd party libraries
[+] tsuraan|16 years ago|reply
Would making it googleable also result in making it viewable as static pages? Under konqueror (3.x), I just get a javadoc looking thing with "Loading..." on the left pane and "welcome to erldocs.com" on the right. I would never ask anybody to write js to support an ancient and unpopular browser, but a static view of the site would be cool.
[+] javery|16 years ago|reply
I would love to see a comments/discussion section for each page. This would be a great way to leave tips/issues you found with the docs. (and could be used to improve the docs)
[+] daleharvey|16 years ago|reply
certainly, thats pretty high on the list of things I want for the site
[+] martythemaniak|16 years ago|reply
Front page full of Erlang... did HN make it to a major publication again?
[+] jmtame|16 years ago|reply
that or 4chan got bored this afternoon?