<div dir="ltr">I think most people would agree documentation is a good thing, and consistency is generally a good thing…  is there an accepted standard on layout and minimum required fields?<div><br></div><div>If not, should there be?<br><div><br></div><div>For example</div><div><br></div><div>- Heading (short description)</div><div>- Description</div><div>- Inputs</div><div>   - Input name + description</div><div>   - Input type</div><div>- Outputs</div><div>   - Output description</div><div>   - Output type</div><div><br></div><div>vs</div><div><br></div><div><div>- Heading (short description)</div><div>- Inputs<br></div><div>   - Input name + description</div><div>   - Input type</div><div>- Outputs</div><div>   - Output description</div><div>   - Output type</div></div><div><div>- Description</div></div><div><br></div><div><br></div><div>I generally like the former, but given that the docstring in python follows the function/method header rather than precedes it, it seems like the latter would be better for python so that descriptions of the inputs and outputs are not separated by lengthy descriptions.</div></div><div><br></div><div>Comments/opinions?</div></div>