Skip to content

Commit

Permalink
Merge pull request #217 from chrultrabook/lts-rewording
Browse files Browse the repository at this point in the history
(RFC) reword LTS warnings and notes
  • Loading branch information
ninelore authored Jan 3, 2025
2 parents 7d8385b + 51bc58b commit 283a928
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 22 deletions.
22 changes: 7 additions & 15 deletions src/docs/faq.md
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.

### 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
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

0 comments on commit 283a928

Please sign in to comment.