Skip to content

docs: add package docstring for SDK landing page (#36) - #218

Merged
bobh66 merged 2 commits into
crossplane:mainfrom
boxcee-interview:fix/issue-36-improve-docs
Sep 15, 2026
Merged

bobh66 merged 2 commits into
crossplane:mainfrom
boxcee-interview:fix/issue-36-improve-docs

Conversation

@boxcee-interview

Copy link
Copy Markdown
Contributor

Closes #36

Summary

The SDK documentation landing page was empty because the package had no init.py with a package-level docstring. pdoc generated per-module pages but no index.

This change adds a comprehensive package docstring that:

  • Provides an SDK overview and quick start example
  • Lists all available modules with descriptions
  • Links to the protobuf-generated API reference
  • Points users to protobuf Python conventions

How to Test

Run the docs generation locally and verify the generated index page shows the package documentation. CI docs job runs on push to main.

Signed-off-by: Moritz Schmitz von Hülst <mschmitzvonhuelst@gmail.com>
Signed-off-by: Moritz Schmitz von Hülst <mschmitzvonhuelst@gmail.com>
@bobh66 bobh66 closed this Sep 15, 2026
@bobh66 bobh66 reopened this Sep 15, 2026
@bobh66 bobh66 closed this Sep 15, 2026
@bobh66 bobh66 reopened this Sep 15, 2026
@bobh66
bobh66 merged commit 5bae249 into crossplane:main Sep 15, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve autogenerated SDK documentation

2 participants