Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

(RFC) reword LTS warnings and notes #217

Merged
merged 4 commits into from
Jan 3, 2025
+10 −22
Merged

(RFC) reword LTS warnings and notes #217

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
95fd144
reword LTS warnings and notes
ninelore Dec 30, 2024
9755847
apply suggestion, fix RW_LEGACY spelling
ninelore Dec 30, 2024
5940cf4
bump date
ninelore Dec 30, 2024
51bc58b
audio script links, spelling
ninelore Dec 31, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 7 additions & 15 deletions src/docs/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ Please read this page before asking for help. Your help request will be pointed

### What OS should I use?

- This depends on your use case. Only you can answer this question. <!-- Not ubuntu plz -->
- This depends on your use case. Only you can answer this question.

### Should I use rw-legacy or full rom?
### Should I use RW_LEGACY or full rom?

- This depends on what you are looking to use your device for. If you are planning on installing Windows or macOS you need to use full rom. Rw-legacy only supports linux.
- This depends on what you are looking to use your device for. If you are planning on installing Windows or macOS you need to use full rom. RW_LEGACY only supports linux.
ninelore marked this conversation as resolved.
Show resolved Hide resolved

### My internal keyboard doesn't work, can I use an external keyboard to get into developer mode?

Expand Down Expand Up @@ -103,25 +103,17 @@ Please read this page before asking for help. Your help request will be pointed

## Linux Questions

### How come audio isn't working on Ubuntu / Ubuntu forks?
### Audio isn't working on Debian, Ubuntu or some other Distribution?

- Ubuntu and Ubuntu-based distros may have issues and are not supported, try switching to another distro. Debian is a great alternative if you are used to Ubuntu.

### Why are Ubuntu/Ubuntu based distros not supported?

- They consistently break packages.
- They have started to force snap on their users.
- They have published an LTS distro with a non-LTS kernel.

Becuse of these things, Ubuntu is unsupported. We will not help you fix issues on Ubuntu.
- Old (>1 year) LTS releases may have issues and are not supported. If the [audio script](installing/installing-linux.md#fixing-audio) doesn't fix the issue, try switching to another distro.

### What Linux distros are recommended?

- See [this page](installing/installing-linux.md).
- Please see [this page](installing/installing-linux.md).

### How can I get audio working under Linux?

- Please see [this GitHub repo](https://github.com/WeirdTreeThing/chromebook-linux-audio)
- Please see [this page](installing/installing-linux.md#fixing-audio)

### How do I get my top row keys on Linux to act like how they did on chromeOS?

Expand Down
10 changes: 3 additions & 7 deletions src/docs/installing/installing-linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,19 +14,15 @@ Only Linux kernel 6.4 or newer is supported.
## Recommended Distributions

::: warning
Ubuntu and Ubuntu-based distributions **may have issues** and are **not supported**.
Old (>1 year) LTS releases **may have issues** and are not supported.
One possible workaround for Debian 12 (Bookworm) and Ubuntu is using a custom kernel. In case of Debian, the [audio script](#fixing-audio) will automatically install it for you. Note that not all issues can be solved with a custom kernel, as the rest of the software on the system is still old.
:::

::: warning
Debian versions older than Debian 12 (Bookworm) are **not supported**. Debian 12 (Bookworm) requires a custom kernel, the [audio script](#fixing-audio) will automatically install it for you.
:::

**Recommended distros as of October 2023 (in no particular order) are:**
**Recommended distros as of December 2024 (in no particular order) are:**

- Arch Linux or EndeavourOS
- Fedora or Ultramarine Linux
- openSUSE Tumbleweed
- Debian 12 (Bookworm)
- Pop!\_OS

## Installation
Expand Down
Loading