Page History

...

1. Go through the default configuration files line by line.
   1. Ensure that any documentation and explanation not yet in the Reference Guide are moved there. Delete any significant passage and replace them with Ref Guide links to ensure a single-source of truth
   2. Delete any default blocks that do not use parameter substitutions and point them to RefGuide for the section and to the API to get the real defaults as appropriate
   3. Delete legacy sections that 'no longer work' (e.g. jmx, possibly EditorialMarkerFactory)
   4. Delete workaround explanations for those migration from Solr prior to Solr 7? (Document them on RefGuide ?)
2. Refactor example directory and associated commands to reduce magic
   1. This mainly affects log configuration and logging directory locations and figuring out what is the directory above solr home
   2. May also involve exploration about configsets and environmental override directories
3. Create new examples
   1. Create a base learning config that is either based on default or has even simpler its own
   2. Setup new dataset (https://www.fakenamegenerator.com can generate 100k records with many interesting fields under CC license (https://creativecommons.org/licenses/by-sa/3.0/us/, similar to CC license used by films example already)
      1. Split records into different formats to demonstrate XML, CSV, multiple JSONs, nested records, etc
   3. Create a number of additive configurations+examples, that augment base configuration to demonstrate specific features with point precision
   4. Move non-essential schema definitions (e.g. languages) from default into alternative schema (new kitchen-sink). Should it be copy/paste XML or API commands, To Be Explored
   5. Update documentation to use new examples to demonstrate features that used to use older configsets
   6. Use short names for analyzer/filter/tokenizer wherever possible (

      Jira
      server ASF JIRA serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key SOLR-13691

      ) - make sure they are easily discoverable in documentation as well
4. Rewrite Getting Started guide that focuses on simplest path through
   1. Start from standalone mode
   2. Explain what is happening with cross-references for more details (teach troubleshooting skills early)
   3. Use API as much as possible, but not at a cost of readability/comprehension
   4. Demonstrate recent APIs/features
   5. Build up to the cloud example
5. Bigger changes that needs further discussion
   1. Delete ALL DIH examples in bulk (

      Jira
      server ASF JIRA serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key SOLR-14066

      , SOLR-14783)
   2. Delete Tika configuration and refer to the manual for configuration and warning (

      Jira
      server ASF JIRA serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key SOLR-13973

      )
   3. Move schemaless mode into learning chain (

      Jira
      server ASF JIRA serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key SOLR-14701

      Jira
      server ASF JIRA serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key SOLR-11741

      )
   4. Delete (refactor) techproducts example and its files (but what about tests?)
   5. Delete Velocity example (

      Jira
      server ASF JIRA serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key SOLR-14065

      )
   6. V2 vs V1 API for examples (V2 is not available for standalone mode in 8.6.1)
   7. post tool vs curl
   8. Interplay with Admin UI changes in progress (e.g. how much to leverage/demonstrate it)
   9. Neither default nor techproducts are realistic production schemes - a whole separate but related discussion (Jira exists?)
   10. It seems that even though Velocity/DIH/others have been deprecated, they have not actually been removed from code/documentation for 9.0 yet. Are there Jiras for that already?

...