documentation for armbian/build#8811 - MANAGE_ACNG

[tabrisnet]

More or less what it says on the tin. Documents a previously existing but modified in armbian/build#8811 build switch.
yes/no/HTTP-URL

[coderabbitai]

Walkthrough

A new documentation entry for the MANAGE_ACNG build switch was added to the Developer Guide. The entry describes two configuration modes: enabling automatic management of an apt-cacher-ng instance on the build host (incompatible with container builds), or specifying a self-hosted apt-cacher-ng URL. Existing documentation entries for LOCAL_MIRROR and MAINLINE_MIRROR remain unchanged.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

This is a straightforward documentation update affecting a single file. The changes involve adding descriptive content for a build configuration option without modifying code logic or existing documentation entries. Review requires basic verification that the documentation accurately describes the MANAGE_ACNG switch behavior and usage patterns.

Suggested reviewers

• igorpecovnik

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The pull request title "documentation for armbian/build#8811 - MANAGE_ACNG" directly and clearly describes the main change in the changeset. It indicates that the PR adds documentation for the MANAGE_ACNG build switch, which is exactly what the raw summary shows. The title is concise, specific (including the issue reference and switch name), and avoids vague or noisy language. It provides sufficient context for someone scanning the history to understand the primary change.
Description Check	✅ Passed	The pull request description is related to the changeset and provides meaningful information about the changes. It explains that the PR documents a previously existing but modified build switch called MANAGE_ACNG, and specifies that the switch accepts values in the form of yes/no/HTTP-URL, which aligns with the documented functionality shown in the raw summary. Although the description uses somewhat colloquial phrasing ("what it says on the tin"), it clearly conveys the purpose and nature of the documentation being added.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

docs/Developer-Guide_Build-Switches.md (1)

372-374: Restructure the second sub-bullet to match the established documentation pattern.

The new MANAGE_ACNG entry deviates from the consistent format used for similar options like MAINLINE_MIRROR and DOWNLOAD_MIRROR. The second sub-bullet uses informal transition language ("but you can provide") instead of the - value: description structure.

Additionally, http URL lacks backticks, unlike yes and no in the parameter specification.

Apply this diff to align with the documented pattern:

- **MANAGE_ACNG** ( `yes` | **`no`** | http URL ): configures use of `apt-cacher-ng`, a cache for debian/ubuntu/etc apt repositories.
+ **MANAGE_ACNG** ( `yes` | **`no`** | `` `http URL` `` ): configures use of `apt-cacher-ng`, a cache for debian/ubuntu/etc apt repositories.
   - `yes` sets up an automatically managed `apt-cacher-ng` instance on the build host. This mode is incompatible with container builds.
-  - but you can provide a URL for a self-managed `apt-cacher-ng` instance, e.g. `"http://apt-cacher.example.com:3142"`
+  - `` `http URL` ``: provide a URL for a self-managed `apt-cacher-ng` instance, e.g. `http://apt-cacher.example.com:3142`

Note: Also removed quotes around the URL example to be consistent with how URLs are shown in code blocks throughout the file.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Jira integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between a3fa3a8 and 8bbc2db.

📒 Files selected for processing (1)

• docs/Developer-Guide_Build-Switches.md (1 hunks)