If you take a look at

http://pkg-build.racket-lang.org/doc/

You'll see that basically all manuals for packages are under the
"Miscellaneous Libraries" category. A small part of this is because
the authors don't know how to use the other categories, described
here:

http://pkg-build.racket-lang.org/doc/raco/setup-info.html?q=getting-started#%28idx._%28gentag._4._%28lib._scribblings%2Fraco%2Fraco..scrbl%29%29%29

However, I think the majority of the reason is that the existing
categories are not appropriate for packages like compiler-goodies,
glob, GLU tessellation, etc.

I've just pushed a commit that allows arbitrary strings to be used as
the categories. These categories are then sorted and put before the
"Miscellaneous" category on the documentation page. Over time, I
expect that we will discover common categories worth coordinating on
(for instance, do we have "Graphics" and "3D Graphics" as separate
ideas?) Here's an example:

(define scribblings '(("openal.scrbl" () ("Audio"))))

I briefly considered enabling a manual to be in many categories and
writing a tag-style interface, but instead went with this smaller
first cut approach.

Please make use of this feature.

Jay

-- 
Jay McCarthy
Associate Professor
PLT @ CS @ UMass Lowell
http://jeapostrophe.github.io

           "Wherefore, be not weary in well-doing,
      for ye are laying the foundation of a great work.
And out of small things proceedeth that which is great."
                          - D&C 64:33

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-dev/CAJYbDanmBM4CUDXOO-fsrmfw_pXeACPOJHH4Ww2bWuvBBT90Sg%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to