Add default building behavior to the documentation

Metadata

Project: craft-parts
Number: #855
Type: issue
State: open
Author: dariuszd21
Labels: Type: Documentation
Created: 2024-09-24 05:33 PM UTC
Updated: 2026-07-15 05:59 PM UTC
Closed: —

Current evaluation

Docs task to document that the CMake plugin builds in Debug by default and encourage switching to Release for packaged apps, with a bonus to cover the Rust plugin. Open, labelled Documentation, last activity 47 days ago; cmake docs already show a CMAKE_BUILD_TYPE example but do not state the Debug default.

Suggested action: keep open

Reason: Labelled Type: Documentation and triaged by a maintainer (dariuszd21) with an internal Jira ticket (CRAFT-3456), so it is categorised and valid. The cmake_plugin.rst already shows a CMAKE_BUILD_TYPE=RelWithDebInfo example but does not state the Debug default or encourage Release for packaged apps, so the request is still unmet; last activity was 47 days ago, so it is not stale enough to close.

Impact: 30 Quick Win: 24.0 Staleness: 55 Complexity: 20 Confidence: 60 Support Request: 0

Issue body

### What needs to get done Update cmake documentation with the information about the possibility of changing the build type to release with an example. It should encourage user to change it for the packaged application, so the resulting binary is more optimized and does not have an unnecessary debug information As a bonus point we may look into other plugins like `rust` and add it there as well. ### Why it needs to get done User may not be aware, that the build system is building libraries and applications in `Debug` mode by default. We should clearly state in the documentation that this is a case, and add and information about possibility of changing that.

Evaluation history

Date	Model	Scores	Action	Summary
2026-09-01 06:14 AM UTC	qwen/qwen3.8-27b	Impact: 30 Quick Win: 24.0 Staleness: 55 Complexity: 20 Confidence: 60 Support Request: 0	keep open	Docs task to document that the CMake plugin builds in Debug by default and encourage switching to Release for packaged apps, with a bonus to cover the Rust plugin. Open, labelled Documentation, last activity 47 days ago; cmake docs already show a CMAKE_BUILD_TYPE example but do not state the Debug default.
2026-07-22 01:24 PM UTC	qwen/qwen3.6-35b-a3b	Staleness: 80 Complexity: 15 Confidence: 85 Support Request: 10	keep open	Documentation update to explain CMake default Debug build mode and how to switch to Release for optimization. Open for over 1.8 years with only a Jira sync bot comment.
2026-07-09 10:04 AM UTC	qwen3.6-35b-a3b-mtp-q6	Staleness: 92 Complexity: 15 Confidence: 80 Support Request: 10	needs triage	Request to update CMake documentation to explain changing the default Debug build type to Release for optimized binaries, with a bonus to cover other plugins. Currently inactive and unlabelled.
2026-06-19 07:54 PM UTC	qwen3.6-35b-a3b-mtp-q6	Staleness: 85 Complexity: 10 Confidence: 75 Support Request: 10	needs triage	Document CMake's default Debug build behavior and provide Release mode configuration examples for optimized binaries. Optionally cover Rust and other plugins. Open, synced to Jira CRAFT-3456, awaiting triage or assignment.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.