You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Jason Gerlowski (JIRA)" <ji...@apache.org> on 2017/12/28 00:02:00 UTC
[jira] [Updated] (SOLR-11574) Extract more ref-guide Java snippets
for building
[ https://issues.apache.org/jira/browse/SOLR-11574?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Jason Gerlowski updated SOLR-11574:
-----------------------------------
Attachment: SOLR-11574.patch
I'm going to be unavailable for a couple weeks for medical reasons, and wanted to upload my progress on this in case anyone else is interested in moving it forward (or giving feedback for when I return).
To summarize the patch, I've extracted Java snippets from {{parallel-sql-interface.adoc}}. {{pagination-of-results.adoc}}, {{the-terms-component.adoc}}, and {{uploading-data-with-solr-cell-using-apache-tika.adoc}}. The other files remain to be done, though there are some that might not benefit from extraction. (Will expand on this in a follow up comment when I have a few more minutes)
> Extract more ref-guide Java snippets for building
> -------------------------------------------------
>
> Key: SOLR-11574
> URL: https://issues.apache.org/jira/browse/SOLR-11574
> Project: Solr
> Issue Type: Improvement
> Security Level: Public(Default Security Level. Issues are Public)
> Components: documentation
> Affects Versions: master (8.0)
> Reporter: Jason Gerlowski
> Priority: Minor
> Attachments: SOLR-11574.patch
>
>
> As a part of SOLR-11032, all of the Java snippets in the "Using SolrJ" ref-guide page were pulled out into separate unit-tests that are built and run as part of the normal Solr build. These snippets appear unchanged in the ref-guide, but are now forcibly kept up-to-date by the build.
> It would be nice to expand this enforcement to other ref-guide pages that contain Java snippets.
> The command {{grep -rIl "source,java" solr/solr-ref-guide/src}} shows all of the ref-guide pages that contain Java snippets. Currently, the list looks like:
> {code}
> ./parallel-sql-interface.adoc
> ./pagination-of-results.adoc
> ./the-terms-component.adoc
> ./enabling-ssl.adoc
> ./transforming-result-documents.adoc
> ./uploading-data-with-solr-cell-using-apache-tika.adoc
> ./language-analysis.adoc
> ./kerberos-authentication-plugin.adoc
> ./stream-decorator-reference.adoc
> ./streaming-expressions.adoc
> ./ping.adoc
> ./basic-authentication-plugin.adoc
> {code}
> This JIRA involves going through the Java snippets in the files listed above and determining whether the snippet is a reasonable candidate for extraction. Maybe very few of these snippets make sense for extraction, but it's a worthwhile investigation.
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org