From f8aa87f3676c8fa60b84370e02feeb20426b164e Mon Sep 17 00:00:00 2001 From: Pat Connors <121328689+nicknamenamenick@users.noreply.github.com> Date: Tue, 5 Mar 2024 13:52:41 +0000 Subject: [PATCH] chore: Opinionated changes to index (#723) * chore: Opinionated changes to index Also fixed some documentation links. * chore: fix capitalization and grammar --- docs/index.md | 47 +++++++++++++++++++++++++++-------------------- 1 file changed, 27 insertions(+), 20 deletions(-) diff --git a/docs/index.md b/docs/index.md index 50dc53c4..31095701 100644 --- a/docs/index.md +++ b/docs/index.md @@ -5,7 +5,7 @@ hide: # Custom Operating System images based on Fedora -This is a collection of container images using Fedora's support for OCI/Docker containers as a [transport and delivery mechanism for operating system content](https://fedoraproject.org/wiki/Changes/OstreeNativeContainerStable). That's nerdspeak for the ultimate Linux client: the reliability of a Chromebook, but with the flexibility and power of a traditional Linux desktop. At long last, we've ascended. +This is a collection of container images using Fedora's support for OCI/Docker containers as a [transport and delivery mechanism for operating system content](https://fedoraproject.org/wiki/Changes/OstreeNativeContainerStable). That's nerd-speak for the ultimate Linux client: the reliability of a Chromebook, but with the flexibility and power of a traditional Linux desktop. At long last, we've ascended! This project provides: @@ -22,7 +22,9 @@ This project provides: -Our main images offer GNOME, KDE, XFCE, LXQt, Budgie, and MATE, with more being [added regularly](https://github.com/orgs/ublue-os/packages). Our [NVIDIA images](https://github.com/orgs/ublue-os/packages?repo_name=nvidia) offer a unique blend of reliability and ease of use that you won't find anywhere else. These are offered in a variety of images to fit your needs: +Our main images offer GNOME, KDE, XFCE, LXQt, Budgie, and MATE, with more being [added regularly](https://github.com/orgs/ublue-os/packages). Our [NVIDIA images](https://github.com/orgs/ublue-os/packages?repo_name=nvidia) offer a unique blend of reliability and ease of use that you won't find anywhere else. + +These are offered in a variety of images to fit the needs of your hardware: - [Asus](https://github.com/orgs/ublue-os/packages?repo_name=asus) - Fedora-based images with [asus-linux.org](https://asus-linux.org) kernels - [Framework](https://github.com/orgs/ublue-os/packages?repo_name=framework) - Framework's recommended Fedora settings @@ -30,19 +32,21 @@ Our main images offer GNOME, KDE, XFCE, LXQt, Budgie, and MATE, with more being ## End-User Focused Images -Check out [Bazzite](https://bazzite.gg), the ultimate gaming setup for your PC, Steam Deck, ASUS ROG Ally and Legion Go. Fedora's upstream pipeline automated directly to your device, nice. +- [Bazzite](https://bazzite.gg) - The ultimate gaming setup for your PC, Steam Deck, ASUS ROG Ally and Legion Go. Fedora's upstream pipeline automated directly to your device, nice. -[Bluefin](https://universal-blue.discourse.group/c/bluefin/6) is a simple to use desktop with the mission of serving a mass audience. The [Bluefin DX](https://universal-blue.discourse.group/t/bluefin-dx-the-bluefin-developer-experience/39) edition is designed to be the ultimate Linux workstation for open source developers. +- [Bluefin](https://projectbluefin.io/) - A simple to use desktop with the mission of serving a mass audience. + + - [Bluefin DX Edition](https://universal-blue.discourse.group/docs?topic=39) - Designed to be the ultimate Linux workstation for open source developers. -## Why would I use these? +### Why would I use these? -These images reflect a more [cloud-native](https://en.wikipedia.org/wiki/Cloud-native_computing) approach to running Linux on your desktop. We feel that a dedicated group of enthusiasts can automate a large amount of toil that plagues existing Linux desktops today. This is achieved by reusing cloud technologies as a delivery mechanism to deliver a more reliable experience. To quote the [goals of bootc](https://github.com/containers/bootc): +These images reflect a more [cloud-native](https://about.gitlab.com/topics/cloud-native/) approach to running Linux on your desktop. We feel that a dedicated group of enthusiasts can automate a large amount of toil that plagues existing Linux desktops today. This is achieved by reusing cloud technologies as a delivery mechanism to deliver a more reliable experience, and to quote the [goals of `bootc`](https://github.com/containers/bootc): -> A toplevel goal is that every tool and technique a Linux system administrator knows around how to build, inspect, mirror and manage application containers also applies to bootable host systems. +> "A top-level goal is that every tool and technique a Linux system administrator knows around how to build, inspect, mirror and manage application containers also applies to bootable host systems." -We like the sound of that, and we're hoping to be your "Desktop DevOps team". Bringing the patterns from the server world to the desktop world means that there is a new layer on top of the distribution. You can now atomically share maintenance of things that people currently do by hand as post-installation. Universal Blue automates that. Contributors use a [gitops approach](https://github.com/open-gitops/documents/blob/main/PRINCIPLES.md) to maintaining these images, all out in the open for everyone to inspect, resulting in a system that now leverages the expertise of system administrators right to your desktop. It's pretty awesome. +We like the sound of that, and we're hoping to be your "Desktop DevOps" team. Bringing the patterns from the server world to the desktop world means that there is a new layer on top of the distribution. -If you want to learn, come hang out. We are here to teach and learn from each other! +Users can now atomically share maintenance of things that people currently do by hand as post-installation. Universal Blue automates these changes. Contributors use a [GitOps approach](https://github.com/open-gitops/documents/blob/main/PRINCIPLES.md) to maintaining these images, all out in the open for anyone to inspect, resulting in a system that now leverages the expertise of system administrators right to your desktop. @@ -54,17 +58,18 @@ If you want to learn, come hang out. We are here to teach and learn from each ot - No compiling or building Nvidia drivers on the local client, they come pre-made on the image - [Kernel mods](https://github.com/ublue-os/akmods) right on the image - Clean separation of the base system from applications and your data - - Integration of Flatpak applications via [Flathub](https://flathub.org/home). + - Integration of Flatpak applications via [Flathub](https://flathub.org/home) - [Toolbox](https://github.com/containers/toolbox) and [Distrobox](https://github.com/89luca89/distrobox) support, run applications from any distribution in a containerized environment - Unbridled customization - Craft your perfect image from scratch or derive from others - Community Maintained - The project is maintained by a community of cloud-native contributors with an [explicit mission](/mission) - Reuses standards-based tooling from cloud - - Built using ostree-enabled [OCI compliant images](https://opencontainers.org/) + - Built using OSTree-enabled [OCI compliant images](https://opencontainers.org/) - Built-in container tools for developers - Consume packages and software from any repo without risking breakage on the client - - Easy consumption of other OCI images, if it's on the [CNCF Landscape](https://landscape.cncf.io/) it's a first class citizen thanks to Podman! + - Easy consumption of other OCI images if it's on the [CNCF Landscape](https://landscape.cncf.io/) + - It's a first class citizen thanks to Podman !!! example "What we mean by reliability:" @@ -72,23 +77,25 @@ If you want to learn, come hang out. We are here to teach and learn from each ot ### Other Features -- Rebase back to pure [Fedora](https://getfedora.org/en/) without reinstallation. This is why we don't call it a distribution, it's an atomic layer of customization on an existing distribution that can be removed. +- Rebase back to pure [Fedora](https://getfedora.org/en/) without reinstallation + - This is why we don't call it a distribution, it's an atomic layer of customization on an existing distribution that can be removed - Fast updates: minimum of once-a-day updates so you're never behind Fedora - Hosted on [ghcr.io](https://github.com/features/packages): - Ninety (_90_) days of image archives allowing for flexible rollback options - Globally distributed via CDN for fast image downloads, thanks Microsoft! - Images signed with standard [sigstore tools](https://www.sigstore.dev/) -- And some more features explained here: +- More features are explained in this video: - + -## Join Us +
-We're always looking for people to help, all skill levels and areas of expertise are welcome. Check out [the roadmap](https://github.com/orgs/ublue-os/projects/1) to get a feel for the project, then: +## Join Us +If you want to learn, come hang out on our [forums](https://universal-blue.discourse.group/). We are here to teach and learn from each other! We're always looking for people to help, all skill levels and areas of expertise are welcome. Check out [the roadmap](https://github.com/orgs/ublue-os/projects/1) to get a feel for the project, then: -- Discuss the project with us on [Discourse](https://universal-blue.discourse.group/). +- Discuss the project with us on [Discourse forums](https://universal-blue.discourse.group/). - [Join our Discord](https://discord.gg/WEu6BdFEtp) - We strive for a safe, inclusive community. -- Pull requests encouraged and accepted. +- Pull requests are encouraged. -If you're building your own custom images feel free to add them to [our awesome list](https://universal-blue.discourse.group/t/list-of-community-created-custom-images/340)! +If you're building your own custom images feel free to add them to [our awesome list](https://universal-blue.discourse.group/docs?topic=340)!