Conversation
…dependency installation
5bf0212 to
48c8032
Compare
|
From my side this PR is ready to merge. I would appreciate a review and confirmation from another team member of @cf-convention/info-mgmt before proceeding, since this touches the documentation build system (but not the normative content). |
|
Thank you for doing this, @cofinoa. Although it's not a change to the conventions, it is a substantial change in this repo, and I think it should be given greater visibility and discussed as a conventions Very soon (I hope) I'll have time to revive the issues in which we are discussing various procedures about changes to conventions, concerning the rules and |
No issue associated: this PR contains incremental tooling and documentation build improvements. There are no changes to the CF specification content.
Summary of changes
This PR improves the documentation build workflow and metadata plumbing:
Makefileto make tool invocation more robust and overridable.environment.ymlfor reproducible Conda/Mamba builds.make test-links) usinglychee.README.mdto document the build workflow.version.adoc, which now acts as the single source of truth for:DRAFTandFINALbuilds are explicit and reproducible.All changes are optional and backward-compatible. System packages (apt) and RubyGems remain supported.
No changes are made to the normative text.
Current behaviour
makebuild produces a DRAFT document.In FINAL mode:
release-date-isoThis ensures that FINAL releases are fully reproducible.
Out of scope for this PR
This PR does not yet define:
The intention is to keep this PR focused on safe, incremental build improvements.
A separate Discussion will be opened with the Information Management Team in order to agree collaboratively on:
Once there is consensus, a follow-up PR can implement the agreed workflow.
Release checklist
For maintainers
After merge:
maincontinues to represent a working draft for the next version