Skip to content

Tweak options docs to give each a header; draw inspiration from typedoc #1606

Description

@cspotcode

Our options page:
https://typestrong.org/ts-node/docs/options

Typedoc options page:
https://typedoc.org/guides/options/#configuration-options

I initially tried to keep our options page as terse as possible, using bulleted lists. But now I've come to feel it's less readable: difficult to vertically scan the names, and they don't have headers so don't appear in the sidebar. Headers also make them directly linkable from elsewhere.

Giving each a header, and resigning ourselves to having a taller page, means we can also do the CLI examples like on typedoc's page. Not sure we should do those for options that we would prefer be specified via tsconfig.json.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions