Doc categories for base libraries

38 views
Skip to first unread message

Asumu Takikawa

unread,
Feb 22, 2016, 3:42:25 PM2/22/16
to Racket Dev
Hi all,

I noticed that on http://docs.racket-lang.org a lot of the main distribution
libraries are still categorized under "Miscellaneous" and therefore get lost in
the big list of user-contributed libraries.

I'm thinking of pushing commits to add categories for the following library
docs (a subset of the ones currently in misc):

2d -> "Syntax Extensions"
data -> "Data Structures"
db -> "Databases"
math -> "Math and Science"
syntax -> "Syntax Extensions"
unix-socket -> 'net-library

Any objections / suggestions?

Cheers,
Asumu

Neil Van Dyke

unread,
Feb 22, 2016, 4:05:03 PM2/22/16
to Asumu Takikawa, Racket Dev
Possibly related: in the all-inclusive docs.racket-lang.org
documentation index, some indication of core vs. user-contributed might
help users decide which package to click upon first.

(I realize things are moving towards more-decentralized, but the "core?"
predicate is one of the easiest predictors of quality/blessedness to
implement right now, technically and socially. I don't recommend star
ratings, usage metrics, or centralized curating right now. I realize
that "core?" predicate will work against SXML-related packages, but I'll
survive.)

Neil V.

Vincent St-Amour

unread,
Feb 29, 2016, 10:11:03 AM2/29/16
to Asumu Takikawa, Racket Dev
I like that.

Vincent
> --
> 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 racket-dev+...@googlegroups.com.
> To post to this group, send email to racke...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/racket-dev/20160222204222.GC4795%40simplyrobot.org.
> For more options, visit https://groups.google.com/d/optout.

Vincent St-Amour

unread,
Feb 29, 2016, 10:13:43 AM2/29/16
to Neil Van Dyke, Asumu Takikawa, Racket Dev
I like the idea. How about listing the "ring" of each package? It's a
more precise distinction than core/non-core (which probably reflects
history more than blessedness), and also highlights quality libraries
that don't happen to be part of the core.

Vincent
> --
> 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 racket-dev+...@googlegroups.com.
> To post to this group, send email to racke...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/racket-dev/56CB77F8.9080106%40neilvandyke.org.
Reply all
Reply to author
Forward
0 new messages