Skip to content

tools, docs: fix stability index isssues

Rodrigo Muino Tomonari requested to merge github/fork/vsemozhetbyt/doc-stability-nits into master
Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • commit message follows commit guidelines

Change 1: do not autolink in doc stability section

Currently, stability index descriptions in documentation.html contain links to their very section which is redundant. This commit prevents tools/doc/html.js from adding this links.

Screenshots of "before" and "after" states:


Before:

st1

After:

st2

Change 2: do not add void wrapping elements to docs

Currently, all the TOC links are wrapped in span elements with class according to stability index of their sections. However, most doc sections have not any stability index, so these spans have useless class stability_undefined. This commit prevents tools/doc/html.js from wrapping TOC links in useless spans.

Screenshots of "before" and "after" states (no visible difference):


Before:

cls1

After:

cls2


This PR eliminates 4402 useless elements in docs and reduces doc size by ~ 176 KB.

Merge request reports