<div dir="ltr"><div><div><br></div><div>Hi All,</div><div><br></div><div>This mail is related to driver-specific documentation in Ironic.</div><div><br></div><div>First a bit of context.  I work on iLO drivers in Ironic. Our team would like to document both Ironic driver related stuff (which is related to Ironic) and hardware related stuff like tested platforms, firmware information, firmware issues, etc (which is not related to Ironic) in the documentation. Today we keep it at two places - ironic related one in ironic tree and (ironic + non-ironic) related one in wiki. It's hard for both people who work on documentation and people who read this documentation to update/refer information in two places.  Hence we decided to raise the review [0] to move the content completely to wiki.  It got mixed response.  While some people are okay with it, but some others (including our ptl :)) feel it's worth putting it in-tree and try to address the problems.</div><div><br></div><div>So what all are the problems ?</div><div>1) Ability to update the driver documentation not-related to Ironic easily without waiting. </div><div>2) To save some core reviewers time who might not be familiar with the hardware.</div><div><br></div><div>To solve the actual problem of updating the documentation easily while keeping it in-tree, I checked with infra folks if a subset of a repository can be +2ed/+Aed by another group.  They confirmed it's not possible (unless there was a communication gap in that conversation, folks can correct me if I am wrong).</div><div><br></div><div>The following are the options that I can think of to address this:</div><div><br></div><div>1) Easy approvals for patches solely related to driver documentation. Once the driver team feels the documentation is ready, it can be +Aed by a core team member skipping the normal process of review. Of course, fixing any comments that come by, but not waiting for the normal rule of 2x+2s.</div><div><br></div><div>2) A separate repository for driver documentation controller by driver developers (a bad idea ??)</div><div><br></div><div>3) Allow to push driver documentation to wiki for those who wish to.</div><div><br></div><div>Thoughts ???</div><div><br></div><div>[0] <a href="https://review.openstack.org/#/c/225602/">https://review.openstack.org/#/c/225602/</a></div></div><div><br></div><div>Regards,</div><div>Ramesh</div><div><br></div></div>