← Back to issue list

docs: add explanation for remote build

View original Github issue

Metadata

Project
snapcraft
Number
#4882
Type
pull request
State
merged
Author
mr-cal
Labels
—
Created
Updated
Closed

Current evaluation

PR #4882 (mr-cal) merged as commit bd49f8db0, adding docs/explanation/remote-build.rst plus index entries to explain current and legacy remote builders; closes documentation issue #4842 (CRAFT-3000).

Resolution: closed resolved

Reason: The PR was approved and merged into main as commit bd49f8db0 ("docs: add explanation for remote build (#4882)"), adding 175 lines of documentation. The commit history for docs/explanation/remote-build.rst begins at bd49f8db0, confirming the new page was created by this PR, and the PR description states it fixes #4842, which is now closed.

Evaluated by: mr-cal-bot

No scores available.

Issue body

- [x] Have you followed the [guidelines for contributing](https://github.com/snapcore/snapcraft/blob/master/CONTRIBUTING.md)? - [x] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)? - [x] Have you successfully run `tox run -m lint`? - [x] Have you successfully run `tox run -e test-py310`? (supported versions: `py39`, `py310`, `py311`, `py312`) ----- This PR explains how the current and legacy remote builders behave. The behavior of the new and legacy remote builders is nuanced enough that we need comprehensive documentation before we can comfortably make behavioral changes. Preview here: https://canonical-snapcraft--4882.com.readthedocs.build/en/4882/explanation/remote-build.html Fixes #4842 (CRAFT-3000)

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha — closed resolved PR #4882 (mr-cal) merged as commit bd49f8db0, adding docs/explanation/remote-build.rst plus index entries to explain current and legacy remote builders; closes documentation issue #4842 (CRAFT-3000).
stealth/space-bunny-alpha — closed resolved Merged #4882 in commit bd49f8db0, documenting current and legacy remote builders and fixing #4842 (CRAFT-3000).
stealth/space-bunny-alpha — closed resolved Merged in PR #4882 (commit bd49f8db0), adding comprehensive documentation of current and legacy remote builder behavior and closing #4842.
qwen/qwen3.6-35b-a3b — — Merged documentation update detailing current and legacy remote builder behaviors. Approved by reviewers and passed CI. Resolves issue #4842 by establishing comprehensive guidance prior to future behavioral changes.
qwen3.6-35b-a3b-mtp-q6 — — Merged documentation update clarifying current and legacy remote builder behavior to establish a baseline before future modifications. Resolves #4842.

Update history

No update history recorded yet.

Related work

  • Likely Fixed By: canonical/snapcraft#4842 (confidence 95%)

    Parent documentation issue 'remote build: document nuances of current and legacy remote builders', closed by this PR (CRAFT-3000).

  • Superseded By: canonical/snapcraft#5994 (confidence 55%)

    Commit b08f1a66e 'chore!: remove legacy remote builder (#5994)' later deleted the legacy-builder half of the page, since one of the two documented behaviours no longer exists.

  • Related To: canonical/snapcraft#4895 (confidence 45%)

    d9c8781a1 'fix(remotebuild): require core20 snaps to use the legacy remote builder' landed just after and edits the same docs page, following on from the documented nuance.

Related issues

Issue Project State Summary Similarity
#4842 remote build: document nuances of current and legacy remote builders snapcraft closed Remote-builder nuances were documented by PR #4882 (commit bd49f8db0), completing the documentation subtask split from #4842.
81%
#597 Document the remote-build command craft-application closed Documentation for `remote-build` added in merged PR #746 (commit 2c32b1ae): new how-to `build-remotely.rst` and reference `remote-builds.rst` covering experimental status, Launchpad workflow, and restrictions. Issue closed as completed.
78%
#800 docs: add remote-build how-to rockcraft merged Merged docs PR canonical/rockcraft#800 (commit a07a6e6a) adding a remote-build how-to guide, +152 lines across 3 docs files, documenting the experimental `rockcraft remote-build` command.
78%
#746 docs: add remote build how-to and reference docs craft-application merged Merged PR #746 added a common documentation module plus generic remote-build how-to and reference guides for Craft Application.
78%
#778 docs: reference docs for remote builds rockcraft merged Merged via rockcraft#778 (commit e5b9bda3): added docs/reference/remote-builds.rst plus a Launchpad remote-build how-to, fixing issue #597. Later refined by #1012, #1118 and metadata pass #1246.
78%
#2702 docs: add common remote build pages charmcraft merged Merged PR #2702 in commit a54f9ac0, adding remote-build how-to and reference pages that closed #2592 and shipped in Charmcraft 4.2.
76%
#2592 Add remote-build documentation charmcraft closed Remote-build how-to and reference documentation was added by merged PR canonical/charmcraft#2702 (commit a54f9ac0) and released in Charmcraft 4.2.
75%
#769 feat: add the remote-build command rockcraft merged Merged PR #769 via commit 8e74936f, adding Rockcraft's experimental remote-build command; documentation followed in PRs #800 and #802.
73%
#6300 Broken docs URL for remote build explanation snapcraft closed Remote-build doc links now use the major version (9.0 instead of 9.0.0), fixed by craft-application PR #1140 in commit 209a1367.
73%
#802 docs: add remote build how-to to 1.8.0 release notes rockcraft merged Merged PR #802 via commit dc39bba8, adding a remote-build how-to reference to the Rockcraft 1.8.0 release notes.
73%