On 11/14/20 8:24 PM, David G. Johnston wrote: > On Fri, Nov 13, 2020 at 1:48 PM Adrian Klaver <adrian.klaver@aklaver.com > <mailto:adrian.klaver@aklaver.com>> wrote: > > Which is an indication that for changes of this scope it would be > prudent to create a mock up and have end users see and comment on > before > rolling them out. > > > There were mockups and people did provide comments. Do you have any
> concrete suggestions on what should have been done, or done differently?
Yes my concrete suggestion was a return to previous layout.
I am referring to the process by which the idea to change the documentation layout was made public so people could review it (see above).
In hindsight it could have been handled better. Waiting longer at different points and making pronouncements on -announce to solicit feedback from people who don't follow -docs. That doesn't change the fact that we need to move forward with a new patch to "fix" things. If the agreement is that fix looks a lot like the old format then so be it. But getting there by reverting doesn't seem doable.