Skip to content

Latest commit

 

History

133 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpinionatedArch

OpinionatedArch is an Arch-based system for one physical person who wants multiple work contexts without maintaining a separate system configuration for each.

Status

OpinionatedArch is in a very early stage, and not a finished general-purpose distribution.

How far along it is stays out of this file, because it moves: What Is Built says what the project has, and Remaining what it has not.

Why It Exists

Arch decides almost nothing, and it offers no method for what comes after. A machine built on it is whatever its owner chose on whichever day they chose it, maintained by hand and from memory, differently each time.

It exists to supply that method: the choices Arch leaves to you are taken once and written down, and there is a way of working that keeps them true as the machine changes. What that buys is a machine you can still account for a year later.

It is also what makes work contexts affordable. Separating personal use from client work is what accounts are for, and on a hand-maintained machine every account is one more to configure and keep in step with the others. Under one method the configuration is already there, so a context costs an account and nothing else.

See What is OpinionatedArch for more.

Installation

There is no medium to boot yet, eventually, there will be an ISO.

The system is installed by running oparch-installer, from an Arch Linux live environment.

See Installation Overview for what it asks and what it does, and oparch-installer for the installer tool itself.

Repository layout

├── src/
├── tests/
├── assets/
└── docs/
  • src/: one directory per tool, and the code they share
  • tests/: the end-to-end harness; the unit tests live with the code they test
  • assets/: managed project assets
  • docs/: project documentation

Why the sources and the tests are laid out this way is Repository Layout.

Documentation

Documentation lives in docs/, organized by type. The Index lists every document; Document Types defines what a document may be and the shape each type takes.

  • General — what OpinionatedArch is and how it works
  • Decisions — one decision per document, with its reasoning
  • Tools — one document per oparch- command, with the formats it defines
  • Development — how the project itself is built and tested
  • Plans — work that is going to be done, and in what order
  • Statewhat is built and what remains

About

Strongly opinionated Arch Linux

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages