Expand description
In-process documentation system for the rl docs CLI command.
Stores all language reference material as static data compiled into the binary - no external files needed at runtime. Organized into three categories:
- stdlib -
StdEntry/FnEntryfor every stdlib module and function - concepts -
ConceptEntryfor language features (types, loops, imports, etc.) - tutorials -
ConceptEntrysteps for the beginner and advanced tutorials
The std_to_markdown, concept_to_markdown, and tutorial_to_markdown
functions render these entries into Markdown for display in the terminal.
Modulesยง
- entries
- Aggregates all documentation entries and exposes them as flat
Vecs for the renderer functions incrate::docs. - entry
- Static data types used to represent all documentation entries.
Structsยง
Functionsยง
- concept_
to_ markdown - Renders concept entries into a Markdown language reference document.
- docs_
to_ json - entries_
to_ ๐markdown - shared renderer for any list of ConceptEntry under a custom header
- find_
fn_ doc - Searches all stdlib entries for a function whose signature starts with
fn_name(. - render_
description ๐ - Renders one
DescriptionEntry(title, kind label, prose, examples, and expected output) into the given output buffer. - render_
related ๐ - Renders a
see_also/related/related_stdliblist as a Markdown line, or an empty string if the list is empty. - std_
to_ markdown - Renders all stdlib entries into a Markdown reference document.
- tutorial_
to_ markdown - Renders tutorial entries into a Markdown step-by-step tutorial document.