Skip to content

Api documentation #23

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 0 additions & 31 deletions doc/source/api/diffpy.fourigui.example_package.rst

This file was deleted.

29 changes: 11 additions & 18 deletions doc/source/api/diffpy.fourigui.rst
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
:tocdepth: -1

|title|
=======

.. |title| replace:: diffpy.fourigui package
diffpy.fourigui package
=======================

.. automodule:: diffpy.fourigui
:members:
Expand All @@ -14,17 +12,12 @@ Subpackages
-----------

.. toctree::
diffpy.fourigui.example_package

Submodules
----------

|module|
--------

.. |module| replace:: diffpy.fourigui.example_submodule module

.. automodule:: diffpy.fourigui.example_submodule
:members:
:undoc-members:
:show-inheritance:
:titlesonly:

diffpy.fourigui.dist
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check this. I doubt we want most of these in the documentation. Also, let's check how they got here....was it a problem with the API process that is also affecting other packages or something that went wrong locally?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sbillinge The API section of the cookiecutter generates documentation for all files (see screenshot, not all files are listed). Not quite sure how to handle this. I will discuss with others
Screenshot 2024-10-08 at 11 00 18 AM

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to double check:

Did you run the following?

python ../../release-scripts/auto_api.py diffpy.fourigui ./src/diffpy/fourigui ./doc/source/api

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am afraid it is due to the relative path issue. If you have the same problem, let's figure this out.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

got it working. I had the ./src/diffpy/fourigui as just .. Will create a new PR

diffpy.fourigui.requirements
diffpy.fourigui.news
diffpy.fourigui..github
diffpy.fourigui.doc
diffpy.fourigui..git
diffpy.fourigui.src
20 changes: 20 additions & 0 deletions doc/source/api/diffpy.fourigui.src.diffpy.fourigui.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
:tocdepth: -1

diffpy.fourigui.src.diffpy.fourigui package
===========================================

.. automodule:: diffpy.fourigui.src.diffpy.fourigui
:members:
:undoc-members:
:show-inheritance:

Submodules
----------

diffpy.fourigui.src.diffpy.fourigui.fourigui module
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. automodule:: diffpy.fourigui.src.diffpy.fourigui.fourigui
:members:
:undoc-members:
:show-inheritance:
17 changes: 17 additions & 0 deletions doc/source/api/diffpy.fourigui.src.diffpy.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
:tocdepth: -1

diffpy.fourigui.src.diffpy package
==================================

.. automodule:: diffpy.fourigui.src.diffpy
:members:
:undoc-members:
:show-inheritance:

Subpackages
-----------

.. toctree::
:titlesonly:

diffpy.fourigui.src.diffpy.fourigui
18 changes: 18 additions & 0 deletions doc/source/api/diffpy.fourigui.src.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
:tocdepth: -1

diffpy.fourigui.src package
===========================

.. automodule:: diffpy.fourigui.src
:members:
:undoc-members:
:show-inheritance:

Subpackages
-----------

.. toctree::
:titlesonly:

diffpy.fourigui.src.diffpy
diffpy.fourigui.src.diffpy.fourigui.egg-info
Loading