Skip to content

Docs automatically/periodically update when new software versions are release (e.g., lotus, go) #2348

Open
@BigLep

Description

@BigLep

Done Criteria

When a new version of critical software referenced in the docs (e.g., lotus, go) is released, the docs should update to reference this version instead of a static outdated version from the paste. This update should come through as a PR that gets reviewed/approved.

Why Important

Many docs.filecoin.io docs are for helping users get started. We won't want to start them off on the wrong foot using outdated versions.

User/Customer

  1. Doc consumers so they get accurate / updated information
  2. Doc maintainers so they don't have to do manual updates

Notes

  1. At least as of 2025-01-10, https://docs.filecoin.io/nodes/lite-nodes/spin-up-a-lite-node is a good example. It references lotus v1.29 even though that is from a previous network version.
  2. A github action workflow where this is done for lotus docs is https://github.com/filecoin-project/lotus-docs/blob/main/.github/workflows/update-version.yml . It handles lotus, lotus-miner, and go. Here is a sample PR it created: Bump Lotus versions (node=1.31.0, miner=1.31.0, go=1.22.7) lotus-docs#775 . (Lotus Docs is using Hugp templating I think for referencing these values. I assume something similar can be done for GitBook.)
  3. Here is an example for ipfs-docs: https://github.com/ipfs/ipfs-docs/blob/main/.github/workflows/update-on-new-ipfs-tag.yml

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions