---
# System prepended metadata

title: '[Todo List] New Documentation mdBook Issues'

---

Link the open issue in the Discourse docs as the "Known issues" with the new documentation and contributing guide!

<hr>

>Emoji usage should be dropped in general

>Youtube links will be mostly removed outside of WolfyReload's videos but they will be linked like this: "watch this [ tutorial ] (link)"

> Steam Gaming Mode category needs to be renamed so it isn't as long (Probably "Handheld/HTPC images"?)

>Bazzite documentation contributing instructions should mention adding your Github username to the bottom of "Documentation Contributors" after PRing

>Bazzite's Website will eventually need to update the links **AFTER** this documentation is stable

# Table of Contents / Index
  - Missing documentation and categorized out of date
  - No emojis on the "subsections" like under the Installation Guide
## General Section
   - Missing Bazzite Resources
   - Missing Reporting Bugs
   - Missing subsection on Installation Troubleshoot Guide under Installation Guide
   - Missing subsection on Secure Boot under Installation Guide
   - Missing subsection on Dual Boot Preliminary Setup and Post-Setup Guide under Installation Guide
   - Missing subsection on Managing & Modding Games under Gaming Guide
   - Missing Common Gaming Issues under Gaming Guide
   - Missing Hardware Compatibility for Gaming under Gaming Guide
- Move Contributing to Bazzite under the Advanced section
- Re-arrange the order of contents to match the Discourse documentation
### Bazzite README
   - No issues
   - However, the README will eventually have to be edited to reflect this new mdBook documentation and not link to the old Discourse version (once it is stable)
### FAQ
- Links to Discourse version of documentation are found\
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)
### Installation Guide Main Page
   - No issues
### Installation Guide for Desktop/Laptop Hardware
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Installing Bazzite onto a Framework Laptop 16
- Missing images

### Installing Bazzite onto a Framework Laptop 13 (AMD/Intel)
- Missing an image

### Installation Guide for for HTPC Setups
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Installation Guide for for Steam Deck
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Installation Guide for for Handheld PCs
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Desktop Environment Tweaks
- Steps are formatted incorrectly
- Links to Discourse version of documentation are found

### Contributing Guide
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Gaming Guide
- Links to Discourse version of documentation are found
- Game Launchers link goes to the Discourse version as opposed the new [mdBook](https://ublue-os.github.io/bazzite/Gaming/Game_Launchers.html) version

### Game Launchers
- Links to Discourse version of documentation are found

## Steam Gaming Mode / Handheld & HTPC Hardware
- "Change physical keyboard layout" should not be its own documentation anymore
  - Even if this affects Gamescope on the desktop too

### Steam Gaming Mode Overview
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Change Physical Keyboard Layout
- Remove this page

### Handheld Wiki
- Handhelds are formatted improperly
- Support ratings are formatted improperly
- Checkmarks are now boring [x] (remove them)
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)

### Steam Deck
- Links to Discourse version of documentation are found
- Checkmarks are now boring [x] (remove them)

### Lenovo Legion Go

- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)
- Checkmarks are now boring [x] (remove them)

### ASUS ROG Ally
- Links to Discourse version of documentation are found
- Checkmarks are now boring [x] (remove them)

### Ayn Handhelds
- Links to Discourse version of documentation are found
- Checkmarks are now boring [x] (remove them)

### GPD Handhelds
- Links to Discourse version of documentation are found
- Checkmarks are now boring [x] (remove them)

### Ayaneo Handhelds
- Links to Discourse version of documentation are found
- Checkmarks are now boring [x] (remove them)
- Missing emojis

### Other Handhelds

- Links to Discourse version of documentation are found
- Formatted improperly for testing HHD

## Installing and Managing Software
- Missing subsection Updating Guide under Updates, Rollbacks, & Rebasing
- Missing subsection Rolling Back System Updates on Updating Guide under Updates, Rollbacks, & Rebasing
- Missing subsection Rebase Guide on Updating Guide under Updates, Rollbacks, & Rebasing
- Missing subsection Bazzite Rollback Helper under Updates, Rollbacks, & Rebasing

### Tutorials for Installing Other Software
- Links to Discourse version of documentation are found
- Pressing the 'next documentation button' loops the Software guides infinitely

### Flatpak
- Links to Discourse version of documentation are found
- Images are scaled too big in comparison to their Discourse counterparts

### ujust
- Links to Discourse version of documentation are found

### Homebrew
- Links to Discourse version of documentation are found

### Distrobox
- Links to Discourse version of documentation are found

### AppImage
- Links to Discourse version of documentation are found

### rpm-ostree
- Links to Discourse version of documentation are found

### Waydroid Setup Guide
- Steps are formatted improperly
- Links to Discourse version of documentation are found

### Updates, Rollbacks, & Rebasing
- Links to Discourse version of documentation are found
- Links to Discourse version of documentation are found
- Links that are by themselves where there should be words (ex of the correct way: [bazzite's website](www.bazzite.gg)
- Images are scaled too big in comparison to their Discourse counterparts
- Needs to be reformatted

## Advanced
- Contributing to Bazzite appears twice, but should stay in this column
- Missing Creating A Custom Bazzite Image

### Auto-Mounting Secondary Drives
- Needs to be reformatted to separate Formatting a Disk, KDE Partition Manager (KDE images) and GNOME Disks (GNOME images), and Alternative Methods in my opinion
- Emergency Mode video tutorial should be linked on all of the pages at the bottom

### Reset User Password
- No issues

### Contributing to Bazzite
- See above under "General" but make sure it stays only in the "Advanced" section