Closed ARYAN-NIKNEZHAD closed 1 month ago
Do I really need it for something this little ?
Yes, we need documentation in .rst
format to support the addition of new features to the package.
Yes, we need documentation in
.rst
format to support the addition of new features to the package.
why is it better ?
Waiting for explanation
@enzofrnt It's optional, but for future enhancements and additional settings in the package, it's a good idea to set up ReadTheDocs from the start. This will streamline documentation as the project grows.
Will not be add.
Description
The project is missing the
docs
folder, which should contain.rst
(reStructuredText) files for documentation. This folder is crucial for generating proper documentation using tools like Sphinx or other documentation generators.Expected Behavior
The project should have a
docs/
directory with the following:index.rst
â The main entry point for the documentation..rst
files (e.g.,installation.rst
,usage.rst
,contributing.rst
, etc.) to cover different aspects of the project.conf.py
file to configure the Sphinx documentation generator, if applicable.Current Behavior
Currently, there is no
docs/
directory in the project repository, making it difficult to generate or view the documentation.Steps to Reproduce
docs/
folder..rst
files and the configuration for documentation.Proposed Solution
Add a
docs/
folder with at least the basic.rst
files:index.rst
installation.rst
usage.rst
If using Sphinx, include a
conf.py
file to manage the documentation settings.Update the documentation and ensure the README file points to the generated docs.
Impact
The absence of proper documentation makes it difficult for new users to understand the project setup, installation, and usage instructions. This may affect the project's adoption and contribution rate.