[jira] [Created] (SOLR-10655) refactor duplicate ref guide content into "snippet" files that can be included

["Hoss Man (JIRA)" <ji...@apache.org>]

Hoss Man created SOLR-10655:
-------------------------------

             Summary: refactor duplicate ref guide content into "snippet" files that can be included
                 Key: SOLR-10655
                 URL: https://issues.apache.org/jira/browse/SOLR-10655
             Project: Solr
          Issue Type: Sub-task
      Security Level: Public (Default Security Level. Issues are Public)
            Reporter: Hoss Man


in cwiki, we were using the "excerpt" and "excerpt-include" macros to mirror some content across multiple pages.

as part of the cwiki->adoc migration, these macros were just evaluated durring export, and the content is now duplicated.

moving forward, we should refactor this duplicated content into "snippet" files that can be included in multiple places.  A few things we need to be careful about when doing this:
* ensuring anchors and relative links are generated in such a way that they are still unique per-section
* that some convention / page attributes are used such that the BuildNavAndPDFBody code doesn't try to include them as "real" pages (or errors that they have no parent)



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org