Skip to content

Miscellaneous documentation updates (part 2)#1764

Merged
debarshiray merged 14 commits intocontainers:mainfrom
debarshiray:wip/rishi/doc-README.md-updates-2026-02-2
Mar 2, 2026
Merged

Miscellaneous documentation updates (part 2)#1764
debarshiray merged 14 commits intocontainers:mainfrom
debarshiray:wip/rishi/doc-README.md-updates-2026-02-2

Conversation

@debarshiray
Copy link
Member

... to pull in the changes made to the website for #1649 and #626

American English spellings like 'containerization' are used elsewhere,
so the British English spelling of 'favourite' should be replaced with
its American counterpart for consistency [1,2].

[1] https://en.wiktionary.org/wiki/containerisation
    https://en.wiktionary.org/wiki/containerization

[2] https://en.wiktionary.org/wiki/favorite
    https://en.wiktionary.org/wiki/favourite

containers#1761
The abbreviation 'etc.' already ends with a period.  When it concludes a
sentence, a second period should not be added.

Fallout from the following:
  * bcc8ffc
  * 596d5c4
  * 6552274

containers#1761
@gemini-code-assist
Copy link

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on a series of miscellaneous documentation updates aimed at improving the clarity, accuracy, and completeness of the Toolbx project's user-facing information. The changes primarily enhance descriptions of container integration capabilities, detail the configuration synchronization between host and container, and refine explanations of various commands and features, ensuring the documentation aligns with the project's current state and addresses previously identified issues.

Highlights

  • Enhanced Documentation for Container Integration: Updated descriptions across README.md, doc/toolbox-create.1.md, and doc/toolbox.1.md to clarify how Toolbx containers seamlessly integrate with the host system, including access to CA certificates and the host file system at /run/host.
  • Detailed Container Configuration Explanation: The doc/toolbox-create.1.md and doc/toolbox-init-container.1.md files now provide more comprehensive information on container configuration, including security considerations, synchronized host configuration files (like /etc/machine-id), and the role of the toolbox init-container entry point in managing immutable OCI containers.
  • Minor Textual Refinements: Various documentation files (NEWS, NEWS.old, README.md, doc/toolbox-enter.1.md, doc/toolbox-rm.1.md, doc/toolbox-run.1.md) received minor reformatting and spelling corrections for improved readability and consistency.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • NEWS
    • Rephrased a bug fix description for improved clarity.
  • NEWS.old
    • Rephrased bullet points for better readability regarding subordinate ID ranges and distro validation.
  • README.md
    • Updated networking description to include CA certificates.
    • Added information about host file system access at /run/host.
    • Corrected "favourite" to "favorite".
  • doc/toolbox-create.1.md
    • Expanded the "Container Configuration" section to include CA certificates, a security disclaimer, detailed synchronization of crucial configuration files (including /etc/machine-id), and methods for container identification.
    • Clarified the role of the toolbox init-container entry point in mitigating OCI container immutability.
    • Added podman-inspect(1) to the "SEE ALSO" section.
  • doc/toolbox-enter.1.md
    • Reformatted the description for the --distro option for improved readability.
  • doc/toolbox-init-container.1.md
    • Added /etc/machine-id to the list of synchronized configuration files.
    • Rephrased descriptions related to OCI container immutability and the entry point's role.
  • doc/toolbox-rm.1.md
    • Reformatted the description for the toolbox rm command for improved readability.
  • doc/toolbox-run.1.md
    • Reformatted descriptions for --container, --preserve-fds, and --release options for improved readability.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@debarshiray debarshiray force-pushed the wip/rishi/doc-README.md-updates-2026-02-2 branch from 42318ef to 16c5de8 Compare February 27, 2026 18:19
... with other paths like /etc/host.conf, /etc/hosts, /etc/localtime,
/run/.toolbxenv, etc.

Fallout from the following:
  * ea452d7
  * 55952c8
  * 637e90c

containers#1764
Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request provides a series of documentation updates across multiple files. The changes primarily involve re-wrapping lines for better readability, correcting minor typographical errors, and updating the content to be more accurate and descriptive of the tool's functionality. Key updates include mentioning access to CA certificates and the host file system at /run/host, adding /etc/machine-id to the list of synchronized files, and standardizing spelling. These changes improve the quality and clarity of the documentation.

@softwarefactory-project-zuul
Copy link

@debarshiray
Copy link
Member Author

recheck

... similar to the website:
  https://containertoolbx.org/doc/

It contains metadata about the Toolbx containers that can be used to
configure the runtime environment inside the containers.  eg., the shell
prompt.

containers#1649
Mention the configuration files that are kept synchronized with the host
in the Container Configuration sub-section for consistency with the
website:
  https://containertoolbx.org/doc/

containers#1649
Mention that the entry point mitigates the immutable nature of OCI
containers in the Container Configuration sub-section for consistency
with the website:
  https://containertoolbx.org/doc/

containers#1649
... similar to the website:
  https://containertoolbx.org/
  https://containertoolbx.org/doc/

The ability to access the host file system from inside the container at
/run/host is an important feature that lets users add their own custom
bind mounts and symbolic links [1].  It emphasizes that Toolbx makes no
promise about security beyond what's already available in the usual
command line environment on the host.

Until now, access to the host file system at /run/host was only
mentioned in the toolbox-create(1) manual [2].  Given its importance, it
should be mentioned as part of the top-level introductory text.

[1] Commit d03a5fe
    containers@d03a5fee80f2f72d
    containers#827

[2] Commit ea452d7
    containers@ea452d7ced8e798a
    containers#512

containers#1649
@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@softwarefactory-project-zuul
Copy link

@debarshiray debarshiray merged commit 6786795 into containers:main Mar 2, 2026
3 checks passed
@debarshiray debarshiray deleted the wip/rishi/doc-README.md-updates-2026-02-2 branch March 2, 2026 13:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant