Skip to content

docs: restore v2.5 docs snapshot and add missing v3.0 versioned docs#808

Merged
vdusek merged 2 commits into
masterfrom
copilot/fix-restore-version-2-5-and-add-version-3-0
May 20, 2026
Merged

docs: restore v2.5 docs snapshot and add missing v3.0 versioned docs#808
vdusek merged 2 commits into
masterfrom
copilot/fix-restore-version-2-5-and-add-version-3-0

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 20, 2026

The v3.0.0 docs versioning run snapshotted docs using the pre-bump version (2.5.1), which overwrote version-2.5 with v3 content and never created version-3.0. This PR restores the correct historical 2.5 snapshot and adds a proper 3.0 snapshot from current docs.

  • Restore 2.5 to the last known good snapshot

    • Replaced website/versioned_docs/version-2.5/ with the tree from 5f7f7b1.
    • Restored website/versioned_sidebars/version-2.5-sidebars.json to match that snapshot.
    • Removes v3-only docs from 2.5 (e.g. upgrading_to_v3.mdx, custom HTTP client/timeouts/typed-models concept pages).
  • Create a proper 3.0 versioned snapshot

    • Added website/versioned_docs/version-3.0/ from current docs/ + API versioned output.
    • Added website/versioned_sidebars/version-3.0-sidebars.json and reformatted to 4-space indentation to match existing versioned sidebar files.
    • Ensures v3-only docs are present under 3.0 (including upgrading_to_v3.mdx and new concepts docs), with the larger v3 api-typedoc.json.
  • Correct version registry ordering

    • Updated website/versions.json to:
      ["3.0", "2.5", "1.12", "0.6"]
  • Keep versioned snapshot clean

    • Removed root-gitignored carryovers from version-3.0 (.ruff_cache, changelog.md, pyproject.toml).

@github-actions github-actions Bot added this to the 141st sprint - Tooling team milestone May 20, 2026
@github-actions github-actions Bot added the t-tooling Issues with this label are in the ownership of the tooling team. label May 20, 2026
Copilot AI changed the title [WIP] Fix restore version 2.5 and add version 3.0 due to release issue docs: restore v2.5 docs snapshot and add missing v3.0 versioned docs May 20, 2026
Copilot finished work on behalf of vdusek May 20, 2026 11:44
@vdusek vdusek marked this pull request as ready for review May 20, 2026 11:44
@codecov
Copy link
Copy Markdown

codecov Bot commented May 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.44%. Comparing base (80a5974) to head (0f54efa).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #808      +/-   ##
==========================================
- Coverage   94.50%   94.44%   -0.07%     
==========================================
  Files          48       48              
  Lines        4916     4916              
==========================================
- Hits         4646     4643       -3     
- Misses        270      273       +3     
Flag Coverage Δ
integration 90.45% <ø> (-0.37%) ⬇️
unit 83.03% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@vdusek vdusek added the adhoc Ad-hoc unplanned task added during the sprint. label May 20, 2026
@vdusek vdusek self-requested a review May 20, 2026 11:52
@vdusek vdusek merged commit 0662b4a into master May 20, 2026
50 of 53 checks passed
@vdusek vdusek deleted the copilot/fix-restore-version-2-5-and-add-version-3-0 branch May 20, 2026 12:34
vdusek added a commit that referenced this pull request May 20, 2026
#806)

## Summary

The v3.0.0 release versioned the docs as `2.5` instead of `3.0`
(overwriting v2.5 content with v3). Root cause:
`manual_version_docs.yaml` reads `uv version --short` from a checkout of
the workflow's dispatch ref (pre-bump), so the job sees the old version.
Run
[#26156928273](https://github.com/apify/apify-client-python/actions/runs/26156928273)
logged `Version: 2.5.1, Major.Minor: 2.5, Major: 2`; bad output is
commit e0a0bc8.

## Fix

- `manual_version_docs.yaml` — optional `version_number` input; snapshot
step uses it when set, falls back to `uv version --short` for manual
dispatch.

Companion data-restore PR: #808.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint. t-tooling Issues with this label are in the ownership of the tooling team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: restore version-2.5 and add version-3.0 (botched v3.0.0 release versioning)

4 participants