Refresh contributor and status guides

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-04-15 12:57:07 +01:00
parent e337b6d4fb
commit 620a98aa9b
3 changed files with 44 additions and 1 deletions
+27 -1
View File
@@ -74,6 +74,31 @@ By sending a message in the room, your MR will not be forgotten or accumulate co
You can read the best practices and guidelines on the [Best practices and guidelines](https://doc.redox-os.org/book/best-practices.html) chapter. You can read the best practices and guidelines on the [Best practices and guidelines](https://doc.redox-os.org/book/best-practices.html) chapter.
## Repository Model for Contributors
RedBearOS should be treated as an overlay distribution on top of Redox, in the same way Ubuntu
relates to Debian.
That means contributors should keep this separation in mind:
- upstream-owned trees such as `recipes/*/source/` are refreshable working copies,
- durable Red Bear-specific work belongs in `local/patches/`, `local/recipes/`, `local/docs/`, and
tracked Red Bear configs,
- if a change exists only in an upstream-owned source tree, it is not yet preserved properly for
long-term Red Bear maintenance.
### WIP rule for contributors
If an upstream recipe or subsystem is still marked WIP, Red Bear treats it as a local project until
upstream promotes it to first-class status.
So for contributors:
- upstream WIP may still be a useful input/reference,
- but fixes intended for Red Bear shipping should normally land in the Red Bear overlay,
- and when upstream later catches up, Red Bear should prefer upstream and retire local patches or
local recipe copies that are no longer needed.
## Development Recommendations and Tips ## Development Recommendations and Tips
- Copy-paste prevent and reduce typos - Copy-paste prevent and reduce typos
@@ -166,7 +191,8 @@ If you don't know how to code in Rust but know other programming languages:
- Web development on the website (we only accept minimal JavaScript code to preserve performance) - Web development on the website (we only accept minimal JavaScript code to preserve performance)
- Write unit tests (may require minimal knowledge of Rust) - Write unit tests (may require minimal knowledge of Rust)
- Port C/C++ programs to Redox (read the `TODO`s of the recipes on the [WIP category](https://gitlab.redox-os.org/redox-os/redox/-/tree/master/recipes/wip)) - Port C/C++ programs to Redox (read upstream WIP `TODO`s as inputs, but do not assume upstream WIP
recipes are automatically the durable Red Bear shipping source of truth)
- Port programs to Redox - Port programs to Redox
If you know how to code in Rust but don't know operating system development: If you know how to code in Rust but don't know operating system development:
+9
View File
@@ -1,9 +1,18 @@
# Hardware Compatibility # Hardware Compatibility
> Hardware compatibility inherited from upstream Redox OS. See https://doc.redox-os.org/book/hardware-support.html for the latest upstream data. > Hardware compatibility inherited from upstream Redox OS. See https://doc.redox-os.org/book/hardware-support.html for the latest upstream data.
>
> **Status note (2026-04-15):** This file is a hardware-reporting/support-tracking surface, not the
> canonical source for profile support language or project execution order. For current Red Bear
> support framing, also use `docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md` and
> `local/docs/PROFILE-MATRIX.md`.
This document tracks the current hardware compatibility of Red Bear OS. This document tracks the current hardware compatibility of Red Bear OS.
Red Bear OS should now treat AMD and Intel machines as equal-priority hardware targets. Older
AMD-first wording in subsystem roadmap documents should be read as historical sequencing rather
than current platform policy.
- [Why are hardware reports needed?](#why-are-hardware-reports-needed) - [Why are hardware reports needed?](#why-are-hardware-reports-needed)
- [What if my computer is customized?](#what-if-my-computer-is-customized) - [What if my computer is customized?](#what-if-my-computer-is-customized)
- [Status](#status) - [Status](#status)
+8
View File
@@ -9,6 +9,14 @@
> that this report still describes as missing, including `redox-driver-sys`, `linux-kpi`, > that this report still describes as missing, including `redox-driver-sys`, `linux-kpi`,
> `firmware-loader`, `redox-drm`, the AMD display path, the Qt6 stack, `config/redbear-kde.toml`, > `firmware-loader`, `redox-drm`, the AMD display path, the Qt6 stack, `config/redbear-kde.toml`,
> and a large `local/recipes/kde/` tree. > and a large `local/recipes/kde/` tree.
>
> **Canonical current-state docs:** use `README.md`, `AGENTS.md`, and
> `docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md` for repository-level current truth. For subsystem
> current-state detail, use the active documents under `local/docs/`.
>
> **WIP interpretation note:** upstream `recipes/wip/...` paths referenced below are part of the
> historical assessment context and should not be read as automatic current Red Bear shipping source
> of truth. Apply the overlay/WIP policy and the WIP migration ledger when interpreting them.
## Current Snapshot ## Current Snapshot