forked from pub-solar/os
Merge branch 'core' into develop
This commit is contained in:
commit
0410acf3d7
16
.github/ISSUE_TEMPLATE/upstream_notice.md
vendored
Normal file
16
.github/ISSUE_TEMPLATE/upstream_notice.md
vendored
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
---
|
||||||
|
name: Upstream notice (Issues or Changes)
|
||||||
|
about: Create an upstream notice to help our research
|
||||||
|
title: '[ <put the upstream project> ]: <topic>'
|
||||||
|
labels: 'upstream'
|
||||||
|
assignees: ''
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Link
|
||||||
|
<!-- just place a link to the upstream issue, or PR -->
|
||||||
|
|
||||||
|
|
||||||
|
## Context
|
||||||
|
<!-- We want to make this as cheap for you as possible.
|
||||||
|
Context is not required but helpful -->
|
53
README.md
53
README.md
|
@ -1,50 +1,35 @@
|
||||||
[![Bors enabled](https://bors.tech/images/badge_small.svg)](https://app.bors.tech/repositories/32678)
|
|
||||||
[![MIT License](https://img.shields.io/github/license/divnix/devos)][mit]
|
|
||||||
[![NixOS](https://img.shields.io/badge/NixOS-unstable-blue.svg?style=flat&logo=NixOS&logoColor=white)](https://nixos.org)
|
[![NixOS](https://img.shields.io/badge/NixOS-unstable-blue.svg?style=flat&logo=NixOS&logoColor=white)](https://nixos.org)
|
||||||
|
[![MIT License](https://img.shields.io/github/license/divnix/devos)][mit]
|
||||||
|
[![Chat](https://img.shields.io/matrix/devos:nixos.org.svg?label=%23devos%3Anixos.org&logo=matrix&server_fqdn=matrix.org)][matrix]
|
||||||
|
|
||||||
> #### ⚠ Advisory ⚠
|
> #### ⚠ Advisory ⚠
|
||||||
> DevOS requires the [flakes][flakes] feature available via an _experimental_
|
> DevOS requires the [flakes][flakes] feature available via an _experimental_
|
||||||
> branch of [nix][nix]. Until nix 3.0 is released, this project
|
> branch of [nix][nix]. Until nix 2.4 is released, this project
|
||||||
> should be considered unstable, though quite usable as flakes have been
|
> should be considered unstable.
|
||||||
> maturing _well_ [for a while](https://github.com/divnix/devos/tree/17713c22d07c54525c728c62060a0428b76dee3b).
|
|
||||||
|
|
||||||
# Introduction
|
### Why?
|
||||||
DevOS grants a simple template to use, deploy and manage [NixOS][nixos] systems
|
Make an awesome template for NixOS users, with consideration for common tools like [home-manager][home-manager],
|
||||||
for personal and productive use. A sane repository structure is provided,
|
|
||||||
integrating several popular projects like [home-manager][home-manager],
|
|
||||||
[devshell][devshell], and [more](./doc/integrations).
|
[devshell][devshell], and [more](./doc/integrations).
|
||||||
|
|
||||||
Striving for ___nix first™___ solutions with unobstrusive implementations,
|
### No. Why _flakes_?
|
||||||
a [flake centric][flake-doc] approach is taken for useful conveniences such as
|
Flakes are a part of an explicit push to improve [Nix's UI](https://github.com/NixOS/nix/blob/master/doc/manual/src/contributing/cli-guideline.md), and have become an intergral part of that effort.
|
||||||
[automatic source updates](./pkgs#automatic-source-updates).
|
|
||||||
|
|
||||||
Skip the indeterminate nature of other systems, _and_ the perceived
|
They also make [Nix expressions](https://nixos.org/manual/nix/unstable/expressions/expression-syntax.html) easier to distribute and reuse with convient [flake references](https://github.com/NixOS/nix/blob/master/src/nix/flake.md#flake-references) for building or using packages, modules, and whole systems.
|
||||||
tedium of bootstrapping Nix. It's easier than you think!
|
|
||||||
|
## Getting Started
|
||||||
|
Check out the [guide](https://devos.divnix.com/start) to get up and running.
|
||||||
|
Also, have a look at [_flake.nix_][toc]. If anything is not immediately
|
||||||
|
discoverable via "[`digga`][digga]'s [`mkFlake`][mk-flake],
|
||||||
|
please file a bug report.
|
||||||
|
|
||||||
### Status: Beta
|
### Status: Beta
|
||||||
Although this project has already matured quite a bit, especially through
|
Although this project has already matured quite a bit, especially through
|
||||||
recent outfactoring of [`digga`][digga], a fair amount of api polishing is still
|
recent outfactoring of [`digga`][digga], a fair amount of api polishing is still
|
||||||
expected. There are unstable versions (0._x_._x_) to help users keep track
|
expected. There are unstable versions (0._x_._x_) to help users keep track
|
||||||
of changes and progress.
|
of changes and progress, and a [`develop`](https://github.com/divnix/devos/tree/develop) branch for the brave 😜
|
||||||
|
|
||||||
## Getting Started
|
## In the Wild
|
||||||
Check out the [guide](https://devos.divnix.com/start) to get up and running.
|
* The original [authors][please]
|
||||||
Also, have a look at [_flake.nix_][toc]. If anything is not immediately
|
|
||||||
discoverable from there through [`digga`][digga] library's [`mkFlake`][mk-flake],
|
|
||||||
please file a bug report.
|
|
||||||
|
|
||||||
## Motivation
|
|
||||||
NixOS provides an amazing abstraction to manage our environment, but that new
|
|
||||||
power can sometimes bring feelings of overwhelm and confusion. Having a turing
|
|
||||||
complete system can easily lead to unlimited complexity if we do it wrong.
|
|
||||||
Instead, we should have a community consensus on how to manage a NixOS system
|
|
||||||
and its satellite projects, from which best practices can evolve.
|
|
||||||
|
|
||||||
___The future is declarative! 🎉___
|
|
||||||
|
|
||||||
## Examples in the Wild
|
|
||||||
The author maintains his own branch, so you can take inspiration, direction, or
|
|
||||||
make critical comments about the [code][please]. 😜
|
|
||||||
|
|
||||||
## Shoulders
|
## Shoulders
|
||||||
This work does not reinvent the wheel. It stands on the [shoulders of the
|
This work does not reinvent the wheel. It stands on the [shoulders of the
|
||||||
|
@ -103,4 +88,4 @@ DevOS is licensed under the [MIT License][mit].
|
||||||
[nixpkgs]: https://github.com/NixOS/nixpkgs
|
[nixpkgs]: https://github.com/NixOS/nixpkgs
|
||||||
[nvfetcher]: https://github.com/berberman/nvfetcher
|
[nvfetcher]: https://github.com/berberman/nvfetcher
|
||||||
[please]: https://github.com/nrdxp/devos/tree/nrd
|
[please]: https://github.com/nrdxp/devos/tree/nrd
|
||||||
[toc]: https://github.com/divnix/devos/blob/core/flake.nix
|
|
||||||
|
|
Loading…
Reference in a new issue