Uploaded image for project: 'Solr'
  1. Solr
  2. SOLR-10290 New Publication Model for Solr Reference Guide
  3. SOLR-10297

Resolve Ref Guide build errors

    XMLWordPrintableJSON

Details

    • Sub-task
    • Status: Resolved
    • Major
    • Resolution: Fixed
    • None
    • None
    • documentation
    • None

    Description

      The asciidoctor tools used to build the HTML and PDF versions of the Ref Guide validate the pages during the build and throw errors during the build when there are problems. Usually these problems are not fatal, but they do indicate inconsistencies in the content that should be resolved. Almost all of the time they are problems with inconsistent heading levels - a h5 follows a h2 for example.

      These errors should be cleaned up so we only see errors we should worry about going forward.

      Attachments

        1. build-errors-HTML-20170315.txt
          11 kB
          Cassandra Targett
        2. build-errors-PDF-20170315.txt
          14 kB
          Cassandra Targett

        Issue Links

          depends upon

          Sub-task - The sub-task of the issue SOLR-10296 Convert existing Ref Guide and post-conversion cleanup

          • Major - Major loss of function.
          • Resolved

          Activity

            People

              Unassigned Unassigned
              ctargett Cassandra Targett
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: