Skip to content
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

Add custom Sphinx documentation processing to reduce repetition and increase clarity for examples in sz-sdk-python #166

Closed
antaenc opened this issue Jan 20, 2025 · 0 comments
Assignees
Labels
python Python programming language V4 To be delivered in V4

Comments

@antaenc
Copy link
Contributor

antaenc commented Jan 20, 2025

Currently example code and output is in both sz-sdk-python and core/grpc causing repetition. We use the documentation from sz-sdk-python (currently) which has file references to examples in its repository.

Adding custom hooks and Python to sphinx configuration (conf.py), this allows sz-sdk-python doc strings to reference both sz-sdk-python-core and sz-sdk-python-core examples and output repository URLs to include the specific core or gRPC examples and output. It also enables sz-sdk-python-core and sz-sdk-python-core ro build their individual docs from the current branch instead of pointing to the main branch. Additional details are in the Sphinx conf.py.

@antaenc antaenc added python Python programming language V4 To be delivered in V4 labels Jan 20, 2025
@antaenc antaenc self-assigned this Jan 20, 2025
@github-actions github-actions bot added the triage Need to triage label Jan 20, 2025
@antaenc antaenc removed the triage Need to triage label Jan 20, 2025
antaenc added a commit that referenced this issue Jan 20, 2025
antaenc added a commit that referenced this issue Jan 28, 2025
@antaenc antaenc mentioned this issue Jan 28, 2025
antaenc added a commit that referenced this issue Jan 28, 2025
antaenc added a commit that referenced this issue Jan 28, 2025
* #153 - Save point

* #153 - Save point

* #153 - Modify examples

* #153 - Testing pytest failure

* #153 - Testing

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Test for unittest change

* #153 - Save point

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Test workflow

* #153 - Save point

* #153 - Save point

* #153 - Save point

* # 153 - Save point

* # 153 - Save point

* #153 - Save point

* #153 - Save point

* #153 - Includes #166 #161 #159

* #153 - Save point

* #153 - Save point

* #170 #169 #166 #161 #159 #153

* Bump twine from 6.0.1 to 6.1.0 (#168) (#172)

Bumps [twine](https://github.com/pypa/twine) from 6.0.1 to 6.1.0.
- [Release notes](https://github.com/pypa/twine/releases)
- [Changelog](https://github.com/pypa/twine/blob/main/docs/changelog.rst)
- [Commits](pypa/twine@6.0.1...6.1.0)

---
updated-dependencies:
- dependency-name: twine
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* #170 #169 #166 #161 #159 #153

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
@antaenc antaenc closed this as completed Jan 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
python Python programming language V4 To be delivered in V4
Projects
None yet
Development

No branches or pull requests

1 participant