Repository navigation
Create a stable way to link to property documentation #98
Description
To support linking to property documentation from Javadocs, it would be nice if the website offered stable way to do this. For example the following link could show the docs for the table.scan.dispatcher property.
https://apache.accumulo.org/docs/property/table.scan.dispatcher
Could start off with this redirecting to the docs for the latest version and change the behavior over time.
For example, it could link to the the docs for different versions of a prop and show the description from the latest version.
Activity
ctubbsii commentedon Nov 1, 2022
There's a high maintenance cost to writing Jekyll plugins to do this automatically. Doing this manually for each property is hugely error prone and a lot of tedious work. Either way, the end result would be a ton of static pages with http redirects that create more work for the user's browser, and I'm not sure there's much value to doing this beyond what we already get with:
https://accumulo.apache.org/docs/2.x/configuration/server-properties#table_scan_dispatcherI don't think doing this is practical.
Maybe this could be done with some sort of Bootstrap UI element, powered by JavaScript on the page, and using http anchors (like we use today) for a persistent link directly to a tab for a specific property, or something... but that's not a lot better than what we have today.