Skip to content

Doc/auto api#318

Merged
weidel-p merged 8 commits intomainfrom
doc/auto-api
Aug 31, 2022
Merged

Doc/auto api#318
weidel-p merged 8 commits intomainfrom
doc/auto-api

Conversation

@weidel-p
Copy link
Copy Markdown
Contributor

Issue Number:

Objective of pull request:

This PR changes the format of several docstrings to allow shpinx to generate documentation.

Pull request checklist

Your PR fulfills the following requirements:

  • Issue created that explains the change and why it's needed
  • Tests are part of the PR (for bug fixes / features)
  • Docs reviewed and added / updated if needed (for bug fixes / features)
  • PR conforms to Coding Conventions
  • PR applys BSD 3-clause or LGPL2.1+ Licenses to all code files
  • Lint (flakeheaven lint src/lava tests/) and (bandit -r src/lava/.) pass locally
  • Build tests (pytest) passes locally

Pull request type

Please check your PR type:

  • Bugfix
  • Feature
  • Code style update (formatting, renaming)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • Documentation changes
  • Other (please describe):

What is the current behavior?

What is the new behavior?

Does this introduce a breaking change?

  • Yes
  • No

Supplemental information

Copy link
Copy Markdown
Contributor

@mathisrichter mathisrichter left a comment

Choose a reason for hiding this comment

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

Nice! Again, please consider removing the docstrings for trivial methods.

Comment thread src/lava/magma/core/decorator.py Outdated
Comment thread src/lava/magma/core/decorator.py Outdated
Comment thread src/lava/magma/core/decorator.py Outdated
Comment thread src/lava/magma/core/process/process.py
Comment thread src/lava/magma/core/run_configs.py
Comment thread src/lava/magma/core/sync/protocol.py Outdated
Comment thread src/lava/proc/sdn/process.py
Copy link
Copy Markdown
Contributor

@PhilippPlank PhilippPlank left a comment

Choose a reason for hiding this comment

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

Looks good. One general remark. I would suggest that each docstring is a sentence which ends with a full stop - similar to our inline comment rules.
I added a comment where I found missing full stops/sentences.

Comment thread src/lava/magma/core/process/variable.py Outdated
Comment thread src/lava/magma/core/sync/protocols/loihi_protocol.py Outdated
Comment thread src/lava/magma/runtime/message_infrastructure/multiprocessing.py Outdated
Comment thread src/lava/magma/runtime/message_infrastructure/nx.py
Comment thread src/lava/magma/runtime/message_infrastructure/nx.py
Comment thread src/lava/proc/sdn/process.py Outdated
Comment thread src/lava/proc/sdn/process.py Outdated
Comment thread src/lava/proc/sdn/process.py Outdated
Comment thread src/lava/magma/compiler/builders/interfaces.py
@PhilippPlank PhilippPlank added the documentation Improvements or additions to documentation label Aug 31, 2022
@weidel-p weidel-p merged commit 780ee5a into main Aug 31, 2022
monkin77 pushed a commit to monkin77/thesis-lava that referenced this pull request Jul 12, 2024
* formatted docstrings for automatic documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants