opengeospatial / CoverageJSON

Public repo for CoverageJSON project
Apache License 2.0
9 stars 7 forks source link

Show TOC level 3 in rendered specification #128

Closed letmaik closed 1 year ago

letmaik commented 1 year ago

The rendered spec at https://opengeospatial.github.io/ogcna-auto-review/21-069.html#toc23 only shows the first two levels of the TOC in the left side navigation. This is quite problematic as a lot of interesting content is in the third level, e.g. CoverageJSON objects (which has Domains below it). It makes consuming the spec harder than necessary and we didn't have that issue in the original non-OGC spec.

@ghobona Is there a way to show TOC level 3 as well?

chris-little commented 1 year ago

@ghobona Does this require a Metanorma infrastructure change? We have just reviewed the spec structure and it does not make sense to raise lower paragraphs to a higher level. Otherwise we would get the same problem as those standards that have a list of 99 Requirements

chris-little commented 1 year ago

@letmaik This is now a known bug in the Metanorma Content Management System: "In contrast with documentation: toclevels controls the PDF TOC levels only, and does not affect HTML or DOC outputs. htmltoclevels controls the HTML TOC levels. doctoclevels controls the DOC TOC levels."

So this is a bug that will be addressed here: https://github.com/metanorma/metanorma-ogc/issues/449