-
Notifications
You must be signed in to change notification settings - Fork 12
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ba97c30
commit 296cb09
Showing
18 changed files
with
1,496 additions
and
921 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
add_one | ||
======= | ||
|
||
.. currentmodule:: my_package.example | ||
|
||
.. autofunction:: add_one |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,20 +1,67 @@ | ||
.. No Errors Test Project documentation master file, created by | ||
sphinx-quickstart on Fri Aug 30 17:07:56 2019. | ||
.. my_package documentation master file, created by | ||
sphinx-quickstart on Tue Mar 22 13:13:41 2022. | ||
You can adapt this file completely to your liking, but it should at least | ||
contain the root `toctree` directive. | ||
Welcome to No Errors Test Project's documentation! | ||
================================================== | ||
Welcome to my_package's documentation! | ||
====================================== | ||
|
||
.. toctree:: | ||
:maxdepth: 2 | ||
:caption: Hello World! | ||
:caption: Contents: | ||
|
||
|
||
Here is where you can write the documentation for your package. | ||
|
||
|
||
Usage | ||
===== | ||
|
||
.. _installation: | ||
|
||
Installation | ||
------------ | ||
|
||
To use `my_package` you need to install X, Y and Z. | ||
|
||
|
||
.. _code: | ||
|
||
Code | ||
---- | ||
|
||
Here is an example of describing the use of your function. | ||
|
||
To add one to a number you can use the ``my_package.add_one()`` function: | ||
|
||
.. py:function:: my_package.add_one(number) | ||
:param number: Should be integer, floating point number or a string. | ||
|
||
If ``number`` is not one of these types, an exception will be raised: | ||
|
||
.. py:exception:: TypeError | ||
Raised if the input is invalid. | ||
|
||
More about how to describe code can be hound | ||
`here <https://www.sphinx-doc.org/en/master/tutorial/describing-code.html>`_ | ||
|
||
|
||
.. | ||
The following section creates an index, a list of modules and a | ||
search page. | ||
Indices and tables | ||
================== | ||
|
||
* :ref:`genindex` | ||
* :ref:`modindex` | ||
* :ref:`search` | ||
|
||
.. | ||
The following will add the signature of the individual functions and pull | ||
their docstrings. | ||
.. automodapi:: my_package.example |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.