Skip to content

docs(ai): add active-development caution to AI package entry point#195

Open
tmgbedu wants to merge 1 commit into
mainfrom
task/ai-caution-1235
Open

docs(ai): add active-development caution to AI package entry point#195
tmgbedu wants to merge 1 commit into
mainfrom
task/ai-caution-1235

Conversation

@tmgbedu

@tmgbedu tmgbedu commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a module-level caution notice to the AI package's entry point (src/fastapi_startkit/ai/__init__.py), stating the package is under active development, may introduce breaking changes, and the team is still experimenting with the best integration approach. Documentation-only — no functional code changes. (task #1235)

Change

Module docstring added at the top of fastapi_startkit/ai/__init__.py:

The AI package is under active development. APIs may change without notice as we experiment with the best integration patterns. Use with caution in production.

Placed as a proper module docstring (reST .. warning:: admonition) so it surfaces in IDE hovers and any generated API docs.

Verification

  • ruff check and ruff format --check pass on the file.
  • Module still parses/compiles; docstring is set (ast.get_docstring → present).

⚠️ Merge freeze in effect — please review but do not merge.

The companion docs-site callouts are in a separate PR against the fastapi-startkit.github.io repo.

Add a module-level docstring warning to the AI package's __init__ noting the
package is under active development, that APIs may change without notice, and
that it should be used with caution in production.
@codecov

codecov Bot commented Jul 23, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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.

1 participant