[racket] How to document a package and access its documentation

From: Stephen Chang (stchang at ccs.neu.edu)
Date: Mon Aug 12 11:53:33 EDT 2013

> I like to browse the documentation on a collection before I install it.
> It is somewhat inconvenient to find out on pkg.racket-lang.org
> whether a package is part of a documented collection or not.

I agree with Jens. This is the feature from planet1 that I miss the most.

For my packages, I host rendered documentation with github project
pages. For example: http://stchang.github.io/parsack/parsack.html

To create a project page, I manually create a gh-pages branch
(https://help.github.com/articles/creating-project-pages-manually) but
I agree that something more official would be good.

> A package picked at random:
>     https://pkg.racket-lang.org/info/arroy
> I need to click at the github link and look for  scribblings to see that
> there are no documentation.
> This package is documented (I still had to go to Github):
>     https://github.com/samth/c.rkt/tree/master/c/scribblings
> But where is a rendered copy?
> /Jens Axel
> ____________________
>   Racket Users list:
>   http://lists.racket-lang.org/users

Posted on the users mailing list.