Hi all
I recently noticed that we have documentation for many collections/packages listed in the Miscellaneous Libraries section of https://docs.racket-lang.org/
There are lots of useful categories available so if you maintain a package or want to help a maintainer help users find their package please make a PR to set an appropriate category.
I’ve put some examples and copied the list of categories below to help you get started but please don’t hesitate to ask if you need a hand.
Best regards
Stephen
The example I noticed was SICP (#lang sicp
) was not listed in the category “Other Languages in the Racket Environment”, but ended up in the catch-all of Miscellaneous Libraries.
This is easy to fix by adding the category to the third part of the definition of scribblings
in info.rkt
file for the collection/package documentation.
Some examples of setting a category:
-
Qi docs: https://github.com/drym-org/qi/blob/main/qi-doc/info.rkt
-
SICP collections:
#lang info
(define scribblings '(("sicp-manual.scrbl" (multi-page) (language))))
This is documented in raco
: Racket Command-Line Tools section 6.3 Controlling raco setup with "info.rkt" Files:
The category list specifies how to show the document in the root table of contents. The list must start with a category, which determines where the manual appears in the root documentation page. A category is either a string or a symbol. If it is a string, then the string is the category label on the root page. If it is a symbol, then a default category label is used. The available symbols and the order of categories on the root documentation page is as below:
- 'getting-started : High-level, introductory documentation, typeset at the same level as other category titles.
- 'language : Documentation for a prominent programming language.
- 'tool : Documentation for an executable.
- 'gui-library : Documentation for GUI and graphics libraries.
- 'net-library : Documentation for networking libraries.
- 'parsing-library : Documentation for parsing libraries.
- 'tool-library : Documentation for programming-tool libraries (i.e., not important enough for the more prominent 'tool category).
- 'interop : Documentation for interoperability tools and libraries.
- All string categories as ordered by string<=?.
- 'library : Documentation for libraries; this category is the default and used for unrecognized category symbols.
- 'legacy : Documentation for deprecated libraries, languages, and tools.
- 'experimental : Documentation for an experimental language or library.
- 'other : Other documentation.
- 'omit : Documentation that should not be listed on the root page or indexed for searching.
- 'omit-start : Documentation that should not be listed on the root page but should be indexed for searching.