snooty-parser

Added

• Add kafka-21-javadoc role for kafka links.

Changed

• Add suffixes to heading IDs to ensure uniqueness (DOP-1734).
• Don't rely on docutils header IDs, fixing e.g. headings with IDs like id1 (DOP-1566).
• Don't include binary name unless requested in :option: links (DOP-1675).
• Update Realm tabsets (contributed by Nick Larew).

Fixed

• Support for subcommands (DOP-1703).

Added

• dotnet-sdk, xamarin, and git-scm extlink roles (DOCSP-13010).
• Blockquote suggestion when unexpected indentation is encountered.
• created_at field in the database to facilitate document expiration (DOP-1318).

Changed

• Remove LiteralBlock node.
• Static assets are now stored in the database with both filename and hash identifier,
  making it easier for the frontend to properly create all needed images (DOP-1643).

Added

• caption option for code blocks (DOP-1604).
• mws directive (DOP-1575).
• Tabs are now defined in rstspec.toml, and validated and sorted by the parser (DOP-1450).

Changed

• Language pills are now provided in the document root node (DOP-1526).

Fixed

• Double tabs-pillstrip bug (DOP-1526).
• Preserve source fileid through includes (DOP-1018).

Changed

• Extlinks should use the target name for label if no label set, not the raw uri (DOP-1581).
• RFC link labels now match legacy (DOP-1581).
• Render role content when target is not found (DOP-1601).
• Bump node extlink version (DOCSP-12335).

Fixed

• Correctly inherit YAML ref names (DOP-1595).
• Improve callable target handling.
• Support required arguments, and apply to rstobjects (DOP-1589).
• Support targets with escaped angle brackets (DOP-1586).

Added

• A dbtools role for linking to database tools docs.
• New Realm rstobjects and extlinks (DOCSP-12508).
• A simple "did you mean" feature for some kinds of typos (DOP-1570).

Changed

• Ambiguous references are now automatically resolved when it is reasonable to do so (DOP-1434).
• Permit version admonitions to have no argument (DOP-1523).
• Incorrect external link syntax now yields an error (DOP-1569).

Fixed

• Incorrectly monospaced text no longer inserts the warning text into the document (DOP-1511).
• Intersphinx inventory entries now have the correct fragment identifiers (DOP-1574).

Added

• Highlighting roles (highlight-red, highlight-yellow, highlight-green, highlight-blue).

Fixed

• Linking to non-lowercase labels (DOP-1534).

Changed

• HTML IDs are now explicit in the AST (DOP-1279).
• Target matching is now case-sensitive (DOP-1277).
• Internal changes to TOC metadata (DOP-981).
• Un-deprecate the red role (DOP-1489).

Fixed

• Assets are now saved to the correct collection.

Added

• add bic-v2.10 role to link to v2.10 bi-connector docs (DOP-1458).
• Ambiguous target candidates are now listed.

Changed

• Batch writes to the database, significantly improving commit performance (DOP-1359).

Fixed

• Support alternative no-title ref_role syntax (DOP-1429).
• Don't suppress missing option/toc include file messages.
• Sort glossary entires case-insensitively (DOP-1428).

Added

• Support for the prefix field in published-branches.yaml.

Added

• OpenAPI support (DOP-1356).
• A charts-onprem role (DOP-1342).

Changed

• Internal error messages are now a little more helpful (DOP-1354).
• Several directive options are no longer required (DEVHUB-206).

Fixed

• Fixed crashes with empty list-tables, and with some obscure markup (DOP-1354, DOP-1394).

Added

• Language Server Protocol Diagnostics now include a source field of "snooty", so that users can
  quickly filter for snooty-related diagnostics in vscode.

Fixed

• Upgraded PyInstaller to fix broken binaries.

Added

• Support for directive fields (DOP-1295).
• Validation of required directive options (DOP-1306).
• Additional performance logging, and the SNOOTY_PERF_SUMMARY environment variable (DOP-1349).
• Various roles and directives.

Fixed

• The list-table directive no longer generates incorrect warnings (DOP-1269).
• Substitutions may now be used in directive arguments (DOP-1230).

Changed

• To prepare for updating the version of the parser used by the VSCode extension,
  the postprocessor has been temporarily disabled in the language server.

Deprecated

• The following directives are deprecated: admonition, danger, caution, and topic (DOP-1243).

Fixed

• Directive arguments were not being properly migrated in the AST.

Added

• Support labels beginning with numbers that contain underscores (DOP-1188)
• Support for extlinks used by Atlas docs (DOP-1233)

Added

• fail_on_diagnostics toml flag (DOP-1132)
• Support additional ordered list labels (DOP-1129)
• Support ordered list "start" attribute (DOP-1210)
• Logging of the parser's version at startup (DOP-1213).
• Snooty parser yields glossary IDs that match the IDs generated by legacy tooling (DOP-1171)

Changed

• Improve string-handling in spec-parser (DOP-1148).

Fixed

• Python 3.7 support.

Changed

• Populate literal include nodes (DOP-876).

Fixed

• RefRole nodes no longer render with the prefix if no title is found (DOP-1073).

Added

• Columns option to card-group.