From d5bf8c21cbdb58a5fc923e2b761694f16e8f87d9 Mon Sep 17 00:00:00 2001 From: alfrix Date: Tue, 12 Sep 2023 00:25:10 -0300 Subject: [PATCH] docs: update to try avoid a common missuses of the docs --- docs/Contact.md | 20 ++++++++++++++++---- docs/Troubleshooting.md | 11 ++++++++--- docs/Troubleshooting/Framebuffer.md | 3 +++ 3 files changed, 27 insertions(+), 7 deletions(-) diff --git a/docs/Contact.md b/docs/Contact.md index 2de0babe..d994b5b2 100644 --- a/docs/Contact.md +++ b/docs/Contact.md @@ -1,11 +1,23 @@ # Contact -There are several ways to contact people who can assist with issues. Discord is going to be the quickest response as -there will be more people in the chat who can help. +There are several ways to contact people who can assist with issues. + +Discord is probably going to provide the quickest response as there are more people in the chat who can help. -## GitHub Issues -You may submit a GitHub issue request for any problems you are having. ## Klipper Community Discord [Look for the channel `#klipper-screen`](https://discord.klipper3d.org/) + + +## Issues or improvements to the docs or the application + +You may submit a GitHub issue request for any bugs you encounter. + +or a Pull Request with translations, features, doc fixes. + +or open an issue describing the changes. + +or even provide ideas for a feature. + +[Github repository](https://github.com/KlipperScreen/KlipperScreen/) diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index d03bcd96..8755f0f2 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -57,11 +57,16 @@ cat /var/log/Xorg.0.log ```sh KlipperScreen-start.sh: (EE) no screens found(EE) ``` - [First check the screen](Troubleshooting/Physical_Install.md) + [Check the screen](Troubleshooting/Physical_Install.md) - [Maybe it's the wrong framebuffer](Troubleshooting/Framebuffer.md) -## Screen is always white / black / blank or no 'No signal' +[Maybe it's the wrong framebuffer](Troubleshooting/Framebuffer.md) + +If you can't fix it, [try using a desktop distro as described here.](Troubleshooting/Last_resort.md) + +If you want to contribute a solution: [Contact](Contact.md) + +## Screen is always ***white*** / ***black*** or ***`No signal`*** If the screen never shows the console even during startup, Then it's typically an improperly installed screen. diff --git a/docs/Troubleshooting/Framebuffer.md b/docs/Troubleshooting/Framebuffer.md index 79d286ce..9dbe5629 100644 --- a/docs/Troubleshooting/Framebuffer.md +++ b/docs/Troubleshooting/Framebuffer.md @@ -40,6 +40,9 @@ check if one of those or similar exist with: ls /usr/share/X11/xorg.conf.d/ ``` +!!! failure "Critical" + ***DO NOT CREATE A FILE***, and only edit if there is more than 1 framebuffer + !!! example you found 99-fbturbo.conf: