I agree, the Ref Guide could use an audit for streaming expressions. I’ve noticed some things missing there too. One that immediately comes to mind is that the significantTerms function accepts and uses a qt parameter, but it’s not listed in the guide.
Jan – I did find the documentation of the REST API (ie: add-expressible) in the old guide. It was added in 8.6 in this Jira: https://issues.apache.org/jira/browse/SOLR-14284, commit is here: https://github.com/apache/lucene-solr/pull/1292/commits/86fafc8f470603c9fb2c1b073974e72f654fcc7d Thanks for the links on how to contribute, I’ll have a look. From: David Eric Pugh <de...@yahoo.com.INVALID> Reply-To: "users@solr.apache.org" <users@solr.apache.org> Date: Thursday, November 14, 2024 at 5:43 AM To: "users@solr.apache.org" <users@solr.apache.org> Subject: Re: Does lack of documentation indicate lack of support or just lack of documentation? Streaming expressions is one of the coolest unique features of Solr! I just committed for Solr 10 the bin/solr stream capablity to run a streaming expressions from the command line! I'd like to see a lot more documentation, and would love to ZjQcmQRYFpfptBannerStart Streaming expressions is one of the coolest unique features of Solr! I just committed for Solr 10 the bin/solr stream capablity to run a streaming expressions from the command line! I'd like to see a lot more documentation, and would love to review PR's. The two areas that jump immediately to mind is updating the JavaDocs on each streaming expression [1] . Describing what they do would help in understanding the code base. The second area is auditing the Ref Guide. The pages that list expressions by type are not complete when you check the source code [2]. [1] https://urldefense.com/v2/url?u=https-3A__github.com_apache_solr_tree_main_solr_solrj-2Dstreaming_src_java_org_apache_solr_client_solrj_io-255B2-255D&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=Y7bnIy0CARfSCySCdVMDrqDtw4YXG0fVfQ2B-6MjTOs69a0e-mEFdkYSXmU9_4Da&s=tW8dB-fST7GIfr8u-shTZIpzcpKyGadIBw1rPMQM9nA&e= https://urldefense.com/v2/url?u=https-3A__solr.apache.org_guide_solr_latest_query-2Dguide_stream-2Dsource-2Dreference.html&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=Y7bnIy0CARfSCySCdVMDrqDtw4YXG0fVfQ2B-6MjTOs69a0e-mEFdkYSXmU9_4Da&s=M3Aifbi-H6PPZWEovRvKKMyXAw_RuPC2t8xILDAq1ok&e= On Thursday, November 14, 2024 at 04:13:40 AM EST, Jan Høydahl <jan....@cominvent.com> wrote: I had a look and can find the content in the old branch for 8.7 https://urldefense.com/v2/url?u=https-3A__github.com_apache_lucene-2Dsolr_blob_branch-5F8-5F7_solr_solr-2Dref-2Dguide_src_streaming-2Dexpressions.adoc&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=Y7bnIy0CARfSCySCdVMDrqDtw4YXG0fVfQ2B-6MjTOs69a0e-mEFdkYSXmU9_4Da&s=2I5Oe5YRJ3vx-neCQOOO5lkHjP2Uc41E34vEh4ErpXQ&e= but not elsewhere. Did you find documentation of the REST api such as 'add-expressible' anywhere in the old guides? Jan > 14. nov. 2024 kl. 09:53 skrev Jan Høydahl <jan....@cominvent.com>: > > Thanks. > > You may find some assistance in contributing here > https://urldefense.com/v2/url?u=https-3A__github.com_apache_solr_blob_main_dev-2Ddocs_how-2Dto-2Dcontribute.adoc&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=Y7bnIy0CARfSCySCdVMDrqDtw4YXG0fVfQ2B-6MjTOs69a0e-mEFdkYSXmU9_4Da&s=4XYmpLtycy6Gg4-CjVSpQAEim2vnaeZKmrg730qx_mc&e= > and here > https://urldefense.com/v2/url?u=https-3A__github.com_apache_solr_tree_main_dev-2Ddocs_ref-2Dguide&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=Y7bnIy0CARfSCySCdVMDrqDtw4YXG0fVfQ2B-6MjTOs69a0e-mEFdkYSXmU9_4Da&s=-YYG8FXX95oTtEgGWkF1KtA7V6JRNcF9dGsGpZ8XEZc&e= > Ask here for help. And the Pull Request doesn't need to be perfect, it can be > polished during review. > > Jan > >> 13. nov. 2024 kl. 22:47 skrev Christine Feldmann >> <cfeldm...@proofpoint.com.INVALID>: >> >> I haven’t yet contributed to the project but I should be able to figure that >> out. I’ll get educated on the process and see if I can make it happen. >> Thanks! >> >> From: Jan Høydahl <jan....@cominvent.com <mailto:jan....@cominvent.com>> >> Reply-To: "users@solr.apache.org <mailto:users@solr.apache.org>" >> <users@solr.apache.org <mailto:users@solr.apache.org>> >> Date: Wednesday, November 13, 2024 at 4:22 PM >> To: "users@solr.apache.org <mailto:users@solr.apache.org>" >> <users@solr.apache.org <mailto:users@solr.apache.org>> >> Subject: Re: Does lack of documentation indicate lack of support or just >> lack of documentation? >> >> Never heard of such intent, likely a miss? Would you be willing to produce a >> Pull Request for bringing the content back? Jan Høydahl > On 13 Nov 2024, at >> 22: 03, Christine Feldmann <cfeldmann@ proofpoint. com. invalid> wrote: > > >> >> >> Never heard of such intent, likely a miss? Would you be willing to produce a >> Pull Request for bringing the content back? >> >> >> >> Jan Høydahl >> >> >> >>> On 13 Nov 2024, at 22:03, Christine Feldmann >>> <cfeldm...@proofpoint.com.invalid> wrote: >> >>> >> >>> Looking for opinions here from those of you that know Solr best… >> >>> >> >>> A change was pushed to do a major revision of the Streaming Expressions >>> guide almost 4 years ago in version 8.8: >>> SOLR-13105<https://urldefense.com/v2/url?u=https-3A__issues.apache.org_jira_browse_SOLR-2D13105&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=SO3LQE6JmrHvOEeReChQNGw6Wr-qxiC6a0g-DZjNQc_dQi6bcMN1mBa8Y-RukmAd&s=wevHDVx3HmSX0XVNlxdqDZ14vY_Xnlp5kOtE2lQBv28&e=><https://urldefense.com/v2/url?u=https-3A__issues.apache.org_jira_browse_SOLR-2D13105&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=SO3LQE6JmrHvOEeReChQNGw6Wr-qxiC6a0g-DZjNQc_dQi6bcMN1mBa8Y-RukmAd&s=wevHDVx3HmSX0XVNlxdqDZ14vY_Xnlp5kOtE2lQBv28&e=%3e>A >>> visual guide to Solr Math Expressions and Streaming Expressions >> >>> >> >>> In this change, the following section was removed: >> >>> >> >>> “Adding Custom Expressions >> >>> Creating your own custom expressions can be easily done by implementing the >>> Expressible<https://urldefense.com/v2/url?u=https-3A__lucene.apache.org_solr_8-5F5-5F0_solr-2Dsolrj_org_apache_solr_client_solrj_io_stream_expr_Expressible.html&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=SO3LQE6JmrHvOEeReChQNGw6Wr-qxiC6a0g-DZjNQc_dQi6bcMN1mBa8Y-RukmAd&s=X7MJTUSRrRYq0r18cEYkDMfZo-D_QXXClnhoU0XZqkA&e=><https://urldefense.com/v2/url?u=https-3A__lucene.apache.org_solr_8-5F5-5F0_solr-2Dsolrj_org_apache_solr_client_solrj_io_stream_expr_Expressible.html&d=DwIFaQ&c=Vxt5e0Osvvt2gflwSlsJ5DmPGcPvTRKLJyp031rXjhg&r=Z5eBKEaiuUFNG8HpjSz8IMDVdE51EhIEeAVWCJN74gY&m=SO3LQE6JmrHvOEeReChQNGw6Wr-qxiC6a0g-DZjNQc_dQi6bcMN1mBa8Y-RukmAd&s=X7MJTUSRrRYq0r18cEYkDMfZo-D_QXXClnhoU0XZqkA&e=%3e>interface. >>> To add a custom expression to the list of known mappings for the /stream >>> and /graph handlers, you just need to declare it as a plugin in >>> solrconfig.xml via: >> >>> <expressible name="custom" class="org.example.CustomStreamingExpression"/>” >> >>> >> >>> There was no mention of deprecating the feature or removing this section. >>> Given the massive size of the diff, I wonder if it was an inadvertent >>> removal. >> >>> >> >>> The feature works. There’s no deprecation of this feature mentioned in any >>> of the Solr docs since it was removed from the guide without explanation. >>> The code itself is not deprecated. >> >>> >> >>> The Config API doc still includes >>> add-expressible/update-expressible/delete-expressible >> >>> >> >>> There is concern in my organization that this feature could be removed at >>> any time without warning because it didn’t make it into the revision of the >>> guide. >> >>> >> >>> Can anyone provide an opinion on how likely that is to happen? >> >>> >> >>> If any of the authors of the guide update are reading, can you comment on >>> why that section was removed? >> >>> >> >>> Thanks in advance, >> >>> Christine >
