Document the remote-build command
Metadata
Current evaluation
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.
Resolution: closed resolved
Reason: Merged PR #746, commit 2c32b1ae ("docs: add remote build how-to and reference docs"), added docs/common/craft-application/reference/remote-builds.rst and how-to-guides/build-remotely.rst covering the experimental warning, Launchpad build farm workflow, and prerequisites (Launchpad account, Git-controlled project, no shallow clones, all architectures built). Both files are registered in docs/conf.py, and maintainer mr-cal closed #597 citing #746.
Evaluated by: mr-cal-bot
No scores available.
Issue body
### What needs to get done
Add some reference documentation for the new(ish) remote-build command, outlining:
- Its experimental/unstable status;
- How it works, in general terms;
- The current restrictions, like how every architecture is built always, the user needs a launchpad account, the project must be git-controlled, etc.
### Why it needs to get done
.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | 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. | |
| stealth/space-bunny-alpha | — | closed resolved | Added remote-build how-to and reference documentation in merged PR #746 (commit 2c32b1ae), completing the documentation request. | |
| qwen/qwen3.6-35b-a3b | — | — | Resolved via issue #746. Documentation for the remote-build command was added, covering its experimental status, general workflow, and restrictions such as mandatory architecture builds, Launchpad account requirements, and git repository dependency. | |
| qwen/qwen3.8-27b |
Impact:
30
Quick Win:
24
Staleness:
70
Complexity:
20
Confidence:
90
Support Request:
10
|
close stale | Request for reference docs on the experimental remote-build command (status, how it works, restrictions). Docs were added in PR #746 covering all requested points; issue is stale and ready to close. | |
| qwen/qwen3.8-27b |
Impact:
30
Quick Win:
24
Staleness:
75
Complexity:
20
Confidence:
90
Support Request:
0
|
close stale | Request for reference documentation of the experimental remote-build command (status, how it works, restrictions). The docs now exist in docs/common/craft-application/reference/remote-builds.rst, added by PR #746; issue is open but the work is done. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
85
Complexity:
20
Confidence:
75
Support Request:
10
|
close stale | Enhancement request to document the remote-build command, including its experimental status, functionality, and restrictions. Currently inactive for over a year with no maintainer engagement. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
10
Confidence:
75
Support Request:
0
|
needs triage | Documentation request for the remote-build command, outlining its experimental status, functionality, and restrictions. Unassigned and inactive for over a year with no maintainer engagement. |
Update history
| Date | Change |
|---|---|
| closed |
Related work
-
Likely Fixed By:
canonical/craft-application#746
(confidence 98%)
Merged PR that added the remote-build how-to and reference documentation; referenced in the closing comment.
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. | |
| #4882 docs: add explanation for remote build | snapcraft | merged | 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). | |
| #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. | |
| #766 Prototype the `remote-build` command/support | rockcraft | closed | Remote-build support was implemented in #769 (commit 8e74936f) and documented in #800, enabling Launchpad-powered builds from the command line. | |
| #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. | |
| #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. | |
| #1118 docs: link corresponding reference to building remotely how-to | rockcraft | merged | Docs-only PR #1118 merged as commit b560404b, adding a cross-reference from the Launchpad how-to guide to the remote-builds reference page, addressing user feedback from UR sessions. | |
| #1185 docs: rework remote build guide | craft-application | closed | Merged in commit 4c49d82b (#1185), recommending Launchpad’s web UI by default and simplifying the remote-build guide. | |
| #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. | |
| #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. |