epugh commented on code in PR #889: URL: https://github.com/apache/solr/pull/889#discussion_r888152926
########## solr/solr-ref-guide/modules/configuration-guide/pages/solr-modules.adoc: ########## @@ -17,32 +17,34 @@ // specific language governing permissions and limitations // under the License. -Solr modules are addon Solr plugins that are not part of solr-core, but officially maintained +Solr Modules are addon Solr plugins that are not part of solr-core, but officially maintained by the Solr project. They provide well-defined features such as the "extracting" module which lets users index rich text documents with Apache Tika. A single module can contain multiple Plugins. Modules were earlier known as "contribs". -Each module produces a separate `.jar` file in the build, and additional dependencies required by -each module are also packaged with the module. This helps keep the main core of Solr small and lean. +Each module produces a separate `.jar` file in the build, and any additional dependencies required +are also packaged with the module and therefore included for you. This helps keep the main core of Solr +small and lean. == Installing a module The easiest way to enable a module is to list the modules you intend to use either in the system property `solr.modules` or in the environment variable `SOLR_MODULES` (e.g. in `solr.in.sh` or `solr.in.cmd`). You can also add a `<str name="modules">` tag to xref:configuration-guide:configuring-solr-xml.adoc[solr.xml]. The expected value is a comma separated list -of module names, e.g. `SOLR_MODULES=extracting,ltr`. This way of adding modules will add -them to the shared class loader, making them available for every collection in Solr. +of module names, e.g. `SOLR_MODULES=extracting,ltr`. This will add +them to the shared class loader, making them available to every collection in Solr. -You can also specify the modules when using the Solr CLI to start Solr: +You can also specify the modules to include when using the Solr CLI to start Solr: [source,bash] ---- bin/solr start -e techproducts -Dsolr.modules=scripting ---- -If you only wish to enable a module for a single collection, you may add `<lib>` tags to `solrconfig.xml` -as explained in xref:configuration-guide:libs.adoc[Lib Directories]. +NOTE: If you only wish to enable a module for a single collection, you may add `<lib>` tags to `solrconfig.xml` +as explained in xref:configuration-guide:libs.adoc[Lib Directories]. This technically isn't considered enabling +a module, as you are instead just loading all the jars in the module's `lib/` folder, thus enabling all that module' plugins. Review Comment: Sometimes we aim for clarity and fall short! I will re-edit it again. The idea is to highlight that by using the `<lib>` you are kind of working around the Module concept..... -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For additional commands, e-mail: issues-h...@solr.apache.org
