docs: improve CrocoDocs API signature and cross-reference rendering

[ndonkoHenri]

Improves CrocoDocs API rendering to make generated reference docs easier to read.

Changes

• Format long method and attribute signatures across multiple lines using Ruff.
• Show modern type syntax like T | None instead of Optional[T].
• Unwrap Annotated[...] in displayed type annotations.
• Preserve return type annotations in method signatures.
• Strip flet_map. and other extension package prefixes from visible cross-reference labels while keeping links/anchors unchanged.

Summary by Sourcery

Improve CrocoDocs-generated API reference readability and consistency across signatures, type annotations, and cross-reference labels.

Enhancements:

• Add Ruff-based formatting for function and attribute signatures, including multi-line wrapping and preservation of return types in generated API docs.
• Modernize rendered type annotations in docs by converting Optional/Union to PEP 604 syntax, unwrapping Annotated, and cleaning alias values.
• Expose preformatted signatures for functions and attributes to the docs UI and render them with preformatted monospace styling.
• Unify stripping of public Flet package prefixes from API labels and reStructuredText cross-reference displays, including extension packages.
• Update internal docs-conventions guidance and changelog skill to account for documentation-focused changelog sections and extension references.

Build:

• Add Ruff as a CrocoDocs tooling dependency for formatting synthetic Python signatures.

Documentation:

• Document how CrocoDocs renders extension attribute references and update flet-map docs wording for animation duration reference.
• Add a changelog entry describing the improved CrocoDocs API reference rendering.

[cloudflare-workers-and-pages]

Deploying flet-website-v2 with    Cloudflare Pages

Latest commit:	b901c05
Status:	🚫  Build failed.

View logs

[sourcery-ai]

Sorry, we are unable to review this pull request

The GitHub API does not allow us to fetch diffs exceeding 300 files, and this pull request has 1951

[cloudflare-workers-and-pages]

Deploying flet-examples with    Cloudflare Pages

Latest commit:	b901c05
Status:	✅  Deploy successful!
Preview URL:	https://a4fe90e0.flet-examples.pages.dev
Branch Preview URL:	https://improve-crocodocs.flet-examples.pages.dev

View logs

[ndonkoHenri]

@sourcery-ai review

[sourcery-ai]

New security issues found

[sourcery-ai]

We've reviewed this pull request using the Sourcery rules engine

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Improves CrocoDocs API reference rendering by generating cleaner, multi-line signatures and displaying more modern, readable type annotations, while also shortening public cross-reference labels for extension packages.

Changes:

• Add Ruff-based formatting + type-annotation modernizing to the CrocoDocs extraction pipeline (formatted signatures, Optional[T] → T | None, unwrap Annotated[...]).
• Render extracted formatted_signature (and preserve return types) in the website’s API UI.
• Strip ft. / flet. / flet_*. prefixes from visible cross-reference labels while keeping the underlying links intact.

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
website/src/css/custom.css	Tweaks whitespace handling for rendered signature-like content.
website/src/components/crocodocs/utils.js	Centralizes Flet display-prefix stripping via a single regex.
website/src/components/crocodocs/ClassBlock.js	Uses extracted formatted_signature and preserves return types in method display.
tools/crocodocs/src/crocodocs/griffe_extract_script.py	Generates modernized annotations and Ruff-formatted signatures during extraction.
tools/crocodocs/pyproject.toml	Adds Ruff dependency to support signature formatting.
tools/crocodocs/.gitignore	Expands ignore patterns for Python tooling/artifacts.
sdk/python/packages/flet-map/src/flet_map/map.py	Docstring line-wrapping tweak for readability.
CHANGELOG.md	Adds a Documentation section entry for the CrocoDocs improvements.
.agents/skills/write-changelog-entry/SKILL.md	Updates changelog-writing guidance to include a Documentation section.
.agents/skills/docs-conventions/SKILL.md	Documents extension reference rendering conventions.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.