Use autosummary for fully-automatic Python module docs generation

[vinnamkim]

Summary

• Ticket no. 109037

• Our auto API docs have been broken for long time. This is because the rst files generated by sphinx.ext.autodoc – Include documentation from docstrings — Sphinx documentation (sphinx-doc.org) are not updated according to the code changes. sphinx.ext.autodoc is semi-automatic way, so that we have to update it mannually at some extent. We need to fix this by replacing it with sphinx.ext.autosummary – Generate autodoc summaries — Sphinx documentation (sphinx-doc.org) to achieve fullly-automatic pipeline for this.

• Remove all files under docs/source/reference and leave two files only. One of them is datumaro_module.rst which auto-generates all *.rst file for Python module docs at docs/source/reference/_autosummary whenever executing make html.

How to test

Checklist

• I have added unit tests to cover my changes.​
• I have added integration tests to cover my changes.​
• I have added the description of my changes into CHANGELOG.​
• I have updated the documentation accordingly

License

• I submit my code changes under the same MIT License that covers the project.
  Feel free to contact the maintainers if that's a concern.
• I have updated the license header for each file (see an example below).

# Copyright (C) 2023 Intel Corporation
#
# SPDX-License-Identifier: MIT

[codecov-commenter]

Codecov Report

Patch and project coverage have no change.

Comparison is base (ce714d2) 78.72% compared to head (e03e508) 78.72%.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop     #973   +/-   ##
========================================
  Coverage    78.72%   78.72%           
========================================
  Files          231      231           
  Lines        26454    26454           
  Branches      5261     5261           
========================================
+ Hits         20825    20826    +1     
  Misses        4404     4404           
+ Partials      1225     1224    -1     

Flag	Coverage Δ
macos-11_Python-3.8	77.75% <ø> (+<0.01%)	⬆️
ubuntu-20.04_Python-3.8	78.69% <ø> (+<0.01%)	⬆️
windows-2019_Python-3.8	78.60% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

see 1 file with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[JihwanEom]

LGTM, could you resolve conflicts?

[vinnamkim]

@wonjuleee @JihwanEom
I resolved conflicts.