Uploaded image for project: 'Solr'
  1. Solr
  2. SOLR-11573

Add live-preview support for ref-guide files using asciidoc-includes

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Trivial
    • Resolution: Fixed
    • 8.0
    • 7.2, 8.0
    • documentation
    • None

    Description

      With the completion of SOLR-11032, the "Using SolrJ" page in the ref-guide now imports some Java code snippets from an external file. This is done to allow the snippets appearing in the documentation to be compiled/run as part of the build...so they will always stay up to date.

      During the ref-guide build, this external file is copied into the ref-guide build directory so that the references to it can be resolved. However, anyone using the "live preview" feature of modern asciidoc editors (Atom, etc.), will find that the snippets don't appear in their live-preview. Depending on your editor, a discrete error message may be displayed.

      It would be nice to fix this "papercut" in usability, or at least provide a workaround. The easier we can make it to improve the docs, the better.

      Attachments

        1. SOLR-11573_meta-docs.patch
          3 kB
          Chris M. Hostetter
        2. SOLR-11573.patch
          6 kB
          Jason Gerlowski

        Activity

          People

            ctargett Cassandra Targett
            gerlowskija Jason Gerlowski
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: