`rockcraft init --profile <name>` prints a link to that profile's documentation. The printed URL contains the full application version, and that path returns 404: ``` $ curl -sIL -o /dev/null -w "%{http_code} %{url_effective}\n" \ https://documentation.ubuntu.com/rockcraft/1.20.0/reference/extensions/spring-boot-framework/ 404 https://ubuntu.com/containers/rockcraft/docs/1.20.0/reference/extensions/spring-boot-framework/ ``` The documentation site serves the major version. `1`, `1.19`, `1.20` and `stable` all resolve to `/docs/1/` and return 200. Only the full `major.minor.patch` form fails. The URL is built by `APP_METADATA.versioned_docs_url`, which calls `render_doc_url` in craft-application. Version 7.1.0, pinned in `uv.lock`, substitutes the version verbatim. Version 7.2.0 added `major_only=True`, which truncates to the major version. The fix already exists upstream; rockcraft just needs to pick it up. ## Changes **`uv.lock`**: craft-application 7.1.0 to 7.2.0. Single package, no transitive dependency changes. **`pyproject.toml`**: constraint floor raised from `>=7.1.0` to `>=7.2.0`. The old constraint already permitted 7.2.0, but the test added here fails against 7.1.0, so leaving the floor at 7.1.0 would permit an environment where the suite does not pass. **`tests/unit/test_application.py`**: regression test. Two notes on how it is written: * It asserts a hard-coded URL instead of deriving one from `versioned_docs_url`. The existing assertion in `tests/unit/test_cli.py` puts the same property on both sides of the comparison, so it passes whatever the URL scheme happens to be. * It injects a release-shaped version. `AppMetadata.version` is an `init=False` field derived in `__post_init__` from `rockcraft.__version__`, and a git checkout produces a setuptools_scm string containing `+g`, which `render_doc_url` short-circuits to `latest` before reaching the truncation. Patching `rockcraft.__version__` and calling `dataclasses.replace(APP_METADATA)` re-runs the real derivation and leaves the module-level singleton untouched. **`tests/unit/services/test_lifecycle.py`**: the `ignore_outdated` literal now includes `.spread-reuse.*`. That value is built entirely inside craft-application, and rockcraft has no references to it. `git log -L` on the line shows one commit, `1856eca build(deps): update craft-application to 6.2.1`, whose message does not mention `ignore_outdated`, so the literal records what craft-application emitted at the time rather than an intended contract. 7.2.0 appends `.spread-reuse.*` so that changes to spread test files do not force a re-pull of sources, which matches the reuse files this repo's CI generates and cleans up. **`docs/conf.py`**: excludes `common/craft-application/how-to-guides/pack-a-pro-artifact.rst`. This one is a required companion to the bump rather than incidental cleanup. 7.2.0 ships that page as new shared documentation, which `link_common_docs` symlinks into the docs tree. The page uses substitutions rockcraft does not define (`|app|`, `|artifact|`, `|an-artifact|`, `|app-link|`, `|app-min-pro-version|`) and a `code-block` `:substitutions:` option that needs `sphinx_substitution_extensions`, which is commented out at `docs/conf.py:240`. Without the exclusion the docs build emits 16 errors and a toctree warning, and `.readthedocs.yaml` sets `fail_on_warning: true`, so the build fails. The exclusion sits alongside the five craft-application pages already excluded for the same reason. If rockcraft wants this page, enabling the extension and defining the substitutions would be a separate change. ## Testing Fail to pass was verified directly. With `uv.lock` reverted to craft-application 7.1.0, both parametrisations of the new test fail: ``` AssertionError: assert 'https://documentation.ubuntu.com/rockcraft/1.20.0' == 'https://documentation.ubuntu.com/rockcraft/1' ``` On 7.2.0 they pass. Full suite on 7.2.0, deterministic ordering: ``` 677 passed, 3 skipped ``` That covers `tests/unit` and `tests/integration`. `tests/spread` was not run, since it needs the spread binary and the self-hosted runners. `make lint` passes in full, including sphinx-lint, vale, woke, linkcheck, twine check and `uv lock --check`. `make docs` completes with zero warnings; `docs/_dev/warnings.txt` is empty. Fixes #1312 --- - [x] I've followed the [contribution guidelines](https://github.com/canonical/rockcraft/blob/main/CONTRIBUTING.md). - [x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/). - [x] I've successfully run `make lint && make test`. - [x] I've added or updated any relevant documentation. The only documentation change is the exclusion described above. - [x] In documents I changed, I [added a meta description](https://canonical-starflow.readthedocs-hosted.com/how-to/add-a-page-meta-description/) if one was missing. No documentation pages were added or edited. - [ ] I've updated the relevant release notes. `docs/release-notes/` currently ends at 1.20 and there is no file for the next release. Happy to add an entry if there is a target.