Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOC-581

The usage of toctree corrupts CDS documentation

XMLWordPrintable

      In the following RSTs a toctree is used to create a list of document links (especially to CDS Manual).
      docs/[guides|https://git.onap.org/doc/tree/docs/guides]/[onap-user|https://git.onap.org/doc/tree/docs/guides/onap-user]/[design|https://git.onap.org/doc/tree/docs/guides/onap-user/design]/[parameter_resolution|https://git.onap.org/doc/tree/docs/guides/onap-user/design/parameter_resolution]/[index.rst|https://git.onap.org/doc/tree/docs/guides/onap-user/design/parameter_resolution/index.rst]
      docs/[guides|https://git.onap.org/doc/tree/docs/guides]/[onap-user|https://git.onap.org/doc/tree/docs/guides/onap-user]/[instantiate|https://git.onap.org/doc/tree/docs/guides/onap-user/instantiate]/[instantiation|https://git.onap.org/doc/tree/docs/guides/onap-user/instantiate/instantiation]/[so2|https://git.onap.org/doc/tree/docs/guides/onap-user/instantiate/instantiation/so2]/[index.rst|https://git.onap.org/doc/tree/docs/guides/onap-user/instantiate/instantiation/so2/index.rst]

      This leads to unwanted behavior, when selecting the CDS document:
      https://docs.onap.org/en/elalto/submodules/ccsdk/cds.git/docs/index.html

      -> Points to the wrong location in the navigation area (left side)

      Solution is to remove the toctree entry and useĀ :ref:`cds_main-doc` instead

            andreasgeissler Andreas Geissler
            andreasgeissler Andreas Geissler
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: