docs: improve CrocoDocs API signature and cross-reference rendering

.agents/skills/docs-conventions/SKILL.md

@@ -34,12 +34,14 @@ Calls :meth:`flet.Page.update` after modifying controls.
 **Rules:**
 
 - **Qualified reference:** `:attr:`flet.Page.route`` — links to the member, displays inline code `Page.route`
+- **Extension reference:** `:attr:`flet_map.Map.animation_curve`` — links to the extension member, displays inline code `Map.animation_curve`
 - **Short display with `~`:** `:attr:`~flet.Page.route`` — links to the member, displays inline code `route`
 - **Local member (same class):** `:attr:`value`` — no qualifier needed
 - **Method with parens:** `:meth:`update`` — do NOT include `()` in the target
 
-For plain class references like `:class:`flet.Page``, the website strips the leading `flet.`
-automatically, so both `:class:`flet.Page`` and `:class:`~flet.Page`` display as inline code `Page`.
+For plain class references like `:class:`flet.Page`` and extension references like
+`:class:`flet_map.Map``, the website strips leading public package aliases automatically,
+so they display as inline code `Page` and `Map`.
 
 **Not supported:**
 

.agents/skills/write-changelog-entry/SKILL.md

@@ -62,6 +62,7 @@ Example split:
      * `### New features`
      * `### Improvements`
      * `### Bug fixes`
+     * `### Documentation`
      * `### Other changes`
 2. Inspect the source of truth for scope and audience.
    * Prefer PR title and PR description/summary over commit noise.
@@ -88,7 +89,9 @@ Example split:
 ## Repo-specific guidance
 
 * Do not mention tests in changelog items unless the change itself is test infrastructure.
-* Do not mention docs/examples unless documentation is the primary deliverable.
+* Use `### Documentation` for docs website, CrocoDocs, generated API reference, examples,
+  guides, or docs tooling changes when documentation is the primary deliverable.
+* Do not mention docs/examples in other sections unless documentation is the primary deliverable.
 * Avoid words like `refactor`, `cleanup`, or `coverage` unless the section is `Other changes` and that is truly the point.
 * If a PR includes one main feature plus supporting docs/tests, write only the main feature.
 * If a PR title is too narrow or too broad, use the PR description and diff to calibrate the final wording.

CHANGELOG.md

@@ -30,9 +30,13 @@
 * Fix 3- and 4-digit hex color shorthand (e.g. `#c00`, `#fc00`) rendering as invisible by expanding them to their full 6/8-digit forms ([#6419](https://github.com/flet-dev/flet/issues/6419), [#6421](https://github.com/flet-dev/flet/pull/6421)) by @ndonkoHenri.
 * Fix `LineChart` (and other charts) silently dropping custom `ChartAxisLabel` entries whose `value` matched a tick only after floating-point rounding (e.g. `0.1`, `0.2`, `0.3`) by switching label lookup to a tolerance-based comparison scaled to the axis interval ([#6445](https://github.com/flet-dev/flet/issues/6445), [#6459](https://github.com/flet-dev/flet/pull/6459)) by @KangZhaoKui.
 
-### Other changes
+### Documentation
 
+* Improve CrocoDocs API reference rendering with formatted signatures, modern type annotations, and cleaner cross-reference labels for extension packages ([#6442](https://github.com/flet-dev/flet/pull/6442)) by @ndonkoHenri.
 * Add `crocodocs watch` command for hot-reload docs development with file-watching, debounced regeneration, and optional child process management ([#6402](https://github.com/flet-dev/flet/pull/6402)) by @ndonkoHenri.
+
+### Other changes
+
 * Add a declarative `ReorderableListView` app example showing add, remove, and reorder flows with stable item identity ([#6374](https://github.com/flet-dev/flet/pull/6374)) by @FeodorFitsner.
 * Remove deprecated module-level `margin`, `padding`, `border`, and `border_radius` helpers (`all()`, `symmetric()`, `only()`, `horizontal()`, `vertical()`) in favor of the corresponding `Margin`, `Padding`, `Border`, and `BorderRadius` classmethods ([#6425](https://github.com/flet-dev/flet/pull/6425)) by @ndonkoHenri.
 * Centralize Linux apt dependencies in `flet.utils.linux_deps` and update CI workflows and publish docs to consume them dynamically ([#6357](https://github.com/flet-dev/flet/issues/6357), [#6383](https://github.com/flet-dev/flet/pull/6383)) by @ndonkoHenri.

sdk/python/packages/flet-map/src/flet_map/map.py

@@ -225,9 +225,8 @@ async def zoom_in(
         Args:
             animation_curve: The curve of the animation. If None (the default),
                 :attr:`flet_map.Map.animation_curve` will be used.
-            animation_duration: The duration of the animation.
-                If None (the default), :attr:`flet_map.Map.animation_duration` will be \
-                used.
+            animation_duration: The duration of the animation. If None (the default),
+                :attr:`flet_map.Map.animation_duration` will be used.
             cancel_ongoing_animations: Whether to cancel/stop all
                 ongoing map-animations before starting this new one.
         """

tools/crocodocs/.gitignore

@@ -1,9 +1,135 @@
-.venv/
+# Byte-compiled / optimized / DLL files
 __pycache__/
-.pytest_cache/
-.ruff_cache/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
 build/
+!templates/build/
+develop-eggs/
 dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+uv.lock
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# VS Code
+.vscode/
+
+# PDM
+.pdm.toml
+__pypackages__/
+
+.ruff_cache/
 *.pyc
 *.pyo
-*.egg-info/

tools/crocodocs/pyproject.toml

@@ -8,6 +8,7 @@ dependencies = [
     "griffe>=2.0.0",
     "packaging>=23.0",
     "PyYAML>=6.0",
+    "ruff>=0.13.1",
     "tomli >=2.0.1; python_version < '3.11'",
     "watchdog >=4.0.0",
 ]