There will be a “Major Changes in Solr 9” page in the Ref Guide for 9.0 that can cover the removed features and available replacements in detail, which similar pages have done for 6, 7, and 8 so far.
I don’t think a page dedicated to deprecated features makes sense beyond the release when the features in fact disappear, which makes the need for such a page somewhat transient. The fact of their deprecation is mentioned in the Upgrade Notes for the release when they are deprecated, and a notice is prominent on each page related to the feature. With this in mind, I’m not sure I see the need for a separate page and would have several questions: Would we have a separate page “Deprecated Features" in 9.0 and then remove it in 9.1? Do we carry around a page only relevant for 9.0 through each version until we someday realize it’s out-of-date and remove it? Does this page duplicate what's in the “Deprecations” Wiki page, or does it augment that information in some other way? Since there would be 2 pages for deprecations, who's maintaining both of them? On Sep 2, 2020, 12:16 PM -0500, Houston Putman <houstonput...@gmail.com>, wrote: > I agree. With the amount of things going away, a CHANGES.txt section and ref > guide page are likely warranted. > > The ref guide page should be separate from the Upgrade Notes page in the ref > guide, as that should already have a fair amount of information. I imagine > this page would explain the overall goal of deprecating these features, then > dive into the plugin/alternatives for each feature that is affected. > > - Houston > > > On Wed, Sep 2, 2020 at 12:51 PM Christine Poerschke (BLOOMBERG/ LONDON) > > <cpoersc...@bloomberg.net> wrote: > > > We have a "New Features" section already and yeah I could see "Deprecated > > > Features" and/or "Relocated Features" and/or "Removed Features" sections > > > or sub-sections go alongside that. > > > > > > Christine > > > > > > From: dev@lucene.apache.org At: 08/30/20 22:28:19 > > > To: dev@lucene.apache.org > > > Subject: Re: Remove section for 9.0 solr/CHANGES > > > > > > > Maybe even distinguish between features that do have a replacement ( > > > > via a plugin ) and those that don't > > > > > > > > > On Sun, Aug 30, 2020 at 1:49 PM Varun Thacker <va...@vthacker.in> > > > > > wrote: > > > > > > Currently when looking at the "Other Changes" section in the > > > > > > CHANGES entry for 9.0 most of the items are removal of features > > > > > > > > > > > > For 9.0 should we have a special "Feature Removal" section within > > > > > > the CHANGES file ? > > > > > > > > > > > > We could add Autoscaling / CDCR / DIH / ANT etc to that secttion > > >