<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Nov 3, 2021 at 2:15 PM John Fulton <<a href="mailto:johfulto@redhat.com">johfulto@redhat.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Wed, Nov 3, 2021 at 1:35 PM Sean Mooney <<a href="mailto:smooney@redhat.com" target="_blank">smooney@redhat.com</a>> wrote:<br>
><br>
> On Wed, 2021-11-03 at 13:02 -0400, James Slagle wrote:<br>
> > Hello TripleO Owls,<br>
> ><br>
> > Our documentation, particularly the deploy guide, has become overly complex<br>
> > with all the branches that TripleO has supported over the years. I see<br>
> > notes that document functionality specific to releases all the way back to<br>
> > Mitaka!<br>
> ><br>
> > In ancient history, we made the decision to not branch our documentation<br>
> > because the work to maintain multiple branches outweighed the effort to<br>
> > just document all releases at once in the same branch.<br>
> ><br>
> > I think the scale has now tipped in the other direction. I propose that we<br>
> > create a stable/wallaby in tripleo-docs, and begin making the master branch<br>
> > specific to Yoga. This would also mean we could clean up all the old notes<br>
> > and admonitions about previous releases on the master branch.<br>
> +1 as some one that very really uses ooo and who always need to look at the documentation<br>
> when i do try to use it i find the current docs very hard to parse due to all the differnt release annotations<br>
> inline. the ooo docs themselve are not actully that extensive upstream and you can read all or most of them in one afternoon<br>
> but parsing them and the parts that apply to the relase you are trying to deploy is a lot more effort then the branached<br>
> docs in other projects. i think this definetly help the new user and might also help those that are more expirnce with ooo too.<br>
<br>
So stable/wallaby would have the notes and admonitions about previous<br>
releases (which are useful if you're using an older version)?<br>
Then we could then make a smaller main branch which is leaner and<br>
focussed on Yoga?<br></blockquote><div><br></div><div>That is correct. stable/wallaby would be for Wallaby and all prior versions. Essentially, as the docs are now.</div><div>Master would be Yoga only. When Yoga is done, we'd branch stable/yoga and master would become Z*.<br></div><div> </div></div>-- <br><div dir="ltr" class="gmail_signature">-- James Slagle<br>--</div></div>