improve guide pages somewhat, add faq

This commit is contained in:
outfoxxed 2025-06-07 05:16:37 -07:00
parent 02f28202d1
commit 7f358936bf
Signed by: outfoxxed
GPG key ID: 4C88A185FB89301E
6 changed files with 99 additions and 73 deletions

View file

@ -4,3 +4,28 @@ description: "Configuring the shell"
index: -1
---
# {frontmatter.title}
See the [Installation and Setup](/docs/guide/install-setup) page to get started.
To write a Quickshell config, start by following the
[Guided Introduction](/docs/guide/introduction) and skimming the
[QML Language Overview](/docs/guide/qml-language).
Before continuing on your own, read the [Item Size and Position](/docs/guide/size-position)
page to learn how to lay out elements in QML. This is significantly different
from many other layout systems such as CSS.
To learn what features Quickshell offers and how to use them, use the
left sidebar and click through the `Quickshell Types` pages. The sidebar
also links QtQuick's type index, which contains most of the visual elements used
to build a UI.
You may also want to check out the [Official Examples] to see some code,
as well as review existing user configs. Do note that Quickshell has evolved
considerably over time and most configs don't reflect current best practice.
[Official Examples]: https://git.outfoxxed.me/quickshell/quickshell-examples
See also the [FAQ](/docs/guide/faq) page, and the [Matrix Room] for help.
[Matrix Room]: https://matrix.to/#/#quickshell:outfoxxed.me