What I've seen happen in other OSS projects is that the URL is versioned. Master is usually under /dev and releases are under /x.y. /latest points to the latest release docs
On Sun, Jan 19, 2020, 1:01 PM Jonathan Wei <jon...@apache.org> wrote: > Thanks for the feedback everyone! > > > Even better if we can publish the docs from master somewhere (in addition > to the current release branch). Both are useful to see. > > That sounds useful too, maybe it can live under a `master` directory > alongside `latest` and the specific version docs. > > On Wed, Jan 15, 2020 at 9:27 PM Furkan KAMACI <furkankam...@gmail.com> > wrote: > > > Hi, > > > > +1! > > > > Kind Regards, > > Furkan KAMACI > > > > 16 Oca 2020 Per, saat 01:56 tarihinde Gian Merlino <g...@apache.org> > şunu > > yazdı: > > > > > I love the idea. > > > > > > Even better if we can publish the docs from master somewhere (in > addition > > > to the current release branch). Both are useful to see. > > > > > > On Tue, Jan 14, 2020 at 7:14 PM Jonathan Wei <jon...@apache.org> > wrote: > > > > > > > Hi all, > > > > > > > > We currently publish a staging version of the Druid docs for an > > upcoming > > > > release at druid.staged.apache.org when we make a release candidate. > > > > > > > > I think it'd be better if we published the staging docs for an > upcoming > > > > release as soon as the code freeze is made, and keep it updated as > doc > > > > backports are made to the upcoming release branch. > > > > > > > > This would allow people doing testing or other evaluation on the > > release > > > > branch to have more usable documentation (using the source markdown > > files > > > > is not ideal since links to other parts of the druid docs don't work, > > and > > > > the navigation assist/style of the actual website isn't there). > > > > > > > > I wanted to get the community's thoughts on this proposed change. > > > > > > > > Thanks, > > > > Jon > > > > > > > > > >
