> Streaming expressions is one of the coolest unique features of Solr! Agree! One thing I dream of is a streaming expression “IDE” with formatter and syntax checker (possibly with autocomplete suggestions)
— > On Nov 15, 2024, at 7:06, Christine Feldmann > <cfeldm...@proofpoint.com.invalid> wrote: > 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 >
