Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 14, 2025

This PR adds comprehensive documentation for the Basic and Restricted boot modes that Purism has developed and upstreamed to the Heads project. These modes provide different security/usability trade-offs for users with varying requirements.

Changes Made

New Documentation Page:

  • Created /Installing-and-Configuring/PurismBootModes.md that explains both boot modes
  • Provides clear descriptions of Basic mode (simplified security) and Restricted mode (advanced security)
  • Links to authoritative Purism documentation for detailed implementation information
  • Includes guidance on choosing between modes based on user requirements

Cross-References Added:

  • Updated Prerequisites.md to reference the new documentation for users who prefer not to use USB security dongles
  • Updated the Installing-and-Configuring index page to include boot modes in the security section

Documentation Approach

Following documentation best practices, this implementation:

  • Provides brief, clear explanations of what each mode offers
  • Links to Purism's authoritative documentation rather than duplicating detailed technical content
  • Explains how these modes fit into the broader Heads ecosystem
  • Helps users make informed decisions about their security configuration

The documentation addresses the community discussions about documenting these modes in the Heads wiki while appropriately deferring to Purism's detailed documentation for implementation specifics.

Fixes #151.


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Copy link
Contributor Author

Copilot AI commented Aug 14, 2025

@tlaurion 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

@Copilot Copilot AI changed the title [WIP] Refer to Purism articles for Basic and Restricted modes Add documentation for Purism Boot Modes (Basic and Restricted) Aug 14, 2025
@Copilot Copilot AI requested a review from tlaurion August 14, 2025 17:02
Copilot finished work on behalf of tlaurion August 14, 2025 17:02
@tlaurion tlaurion marked this pull request as ready for review August 14, 2025 18:54
@tlaurion
Copy link
Collaborator

LGTM. Waiting for community input, would merge as is.

@tlaurion tlaurion merged commit c363333 into master Aug 21, 2025
1 check passed
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.

Refer to Purism articles for Basic and Restricted modes
2 participants