Karthikeyan Singaravelan <tir.karthi@gmail.com> added the comment: I have added a doc note under make_file docs which has docs for fromdesc and todesc. make_table refers to make_file for fromdesc and todesc docs. I have added a screenshot of the rendering using note and warning directive. I feel note directive is sufficient for this. Placement and wording suggestions are welcome. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue35603> _______________________________________