On Sat, Dec 19, 2015 at 5:04 PM, Jay McCarthy <[email protected]> wrote:
> 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 think you're right in both cases. I didn't know about scribble categories. I *did* know about the tagging feature at http://pkgs.racket-lang.org/ (which is independent of the package info, IIRC). > > 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. > I do think this is a good idea, but I also think it might be confusing for the package server to have its own, completely distinct, categorization scheme. > > Please make use of this feature. > Will do. -Jon > > 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. > -- 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/CAKfDxxywy1SuEczJN7VwZrKYfbMSxrVCcVVAmDmtjh0cxe_d_w%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
