Update README.

doc/developers.md

@@ -0,0 +1,83 @@
+# Development
+
+## Prerequisites
+- A working [Rust installation](https://www.rust-lang.org/tools/install)
+- Python 3 (needed for building `rust-xcb` dependency)
+
+On Linux, you also need:
+
+- `pkgconf` (sometimes called `pkg-config`)
+- Development headers for the aforementioned runtime dependencies:
+  - Debian and derivatives:
+    ```sh
+    sudo apt install libdbus-1-dev libncursesw5-dev libpulse-dev libssl-dev libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev
+    ```
+  - Fedora:
+    ```sh
+    sudo dnf install dbus-devel libxcb-devel ncurses-devel openssl-devel pulseaudio-libs-devel
+    ```
+  - Arch and derivatives:
+    ```sh
+    # headers are included in the base packages
+    sudo pacman -S dbus libpulse libxcb ncurses openssl
+    ```
+
+## Debugging
+For simple debugging, you can pass a debug log filename:
+
+```sh
+cargo run -- -d debug.log
+```
+
+It can be difficult to debug a TUI application as it might not run well in an IDE terminal or the
+terminal could be used by the text editor. It is however possible to run ncspot in its own process
+and attach a debugger. On Linux this can be achieved with `gdb` or `lldb`. It is important that
+[ptrace](https://www.kernel.org/doc/html/latest/admin-guide/LSM/Yama.html) is disabled for this to
+work. To disable it, execute `echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope`. This will allow
+any process to inspect the memory of another process. It is automatically re-enabled after a reboot.
+
+If ncspot has crashed you can find the latest backtrace at `~/.cache/ncspot/backtrace.log`.
+
+## Compiling
+Compile and install the latest release with `cargo-install`:
+
+```sh
+cargo install ncspot
+```
+
+Or clone and build locally:
+
+```sh
+git clone https://github.com/hrkfdn/ncspot
+cargo build --release
+```
+
+**You may need to manually set the audio backend on non-Linux OSes.** See [Audio
+Backends](#audio-backends).
+
+## Audio Backends
+ncspot uses PulseAudio by default. Support for other backends can be enabled with the following
+commands.
+
+PortAudio for BSD's or macOS
+```sh
+cargo build --no-default-features --features portaudio_backend,pancurses_backend
+```
+
+Rodio for Windows
+```sh
+cargo build --no-default-features --features rodio_backend,pancurses_backend
+```
+
+## Other Features
+Here are some auxiliary features you may wish to enable:
+
+| Feature           | Default | Description                                                                                |
+|-------------------|---------|--------------------------------------------------------------------------------------------|
+| `cover`           | off     | Add a screen to show the album art.                                                        |
+| `mpris`           | on      | Control `ncspot` via dbus. See [Arch Wiki: MPRIS](https://wiki.archlinux.org/title/MPRIS). |
+| `notify`          | on      | Send a notification to show what's playing.                                                |
+| `share_clipboard` | on      | Ability to copy the URL of a song/playlist/etc. to system clipboard.                       |
+
+Consult [Cargo.toml](/Cargo.toml) for the full list of supported features.
+

doc/package_maintainers.md

@@ -0,0 +1,36 @@
+# Packaging
+[![Packaging status](https://repology.org/badge/vertical-allrepos/ncspot.svg)](https://repology.org/project/ncspot/versions)
+
+## Compilation Instructions
+ncspot makes use of the standard Cargo build system for everything. To compile a release version,
+execute `cargo build --release` in the terminal from the project root. The executable file can be
+found at `target/release/ncspot`. For detailed build instructions, have a look at [the developer
+documentation](/doc/developers.md).
+
+Additional features can be included by appending them to the build command. A list of all the
+available features can be found in the [Cargo.toml](/Cargo.toml) under the `[features]` table. To
+activate a feature, include its name like `cargo build --release --features feature1,feature2,...`.
+To disable the default features, add `--no-default-features` to the command.
+
+## Other Provided Files
+The following is a list of other files that are provided by ncspot. Some of them need to be
+generated. Execute `cargo xtask --help` for more information.
+- LICENSE
+- images/logo.svg (optional)
+- misc/ncspot.desktop (for Linux systems)
+- misc/ncspot.1 (for Linux systems)
+- misc/ncspot.bash (bash completions)
+- misc/\_ncspot (zsh completions)
+- misc/ncspot.fish (fish completions)
+- misc/ncspot.elv (elvish completions)
+- misc/\_ncspot.ps1 (powershell completions)
+
+## Building a Debian Package
+The [`cargo-deb`](https://github.com/kornelski/cargo-deb#readme) package can be used to build a
+Debian package with the following commands. The package will be generated in `target/debian/`.
+
+```sh
+cargo install cargo-deb
+cargo deb
+```
+

doc/resource_footprint.md

@@ -0,0 +1,8 @@
+## Resource Footprint Comparison
+Measured using `ps_mem` on Linux during playback:
+
+| Client  | Private Memory | Shared Memory | Total      |
+|---------|----------------|---------------|------------|
+| ncspot  | 22.1 MiB       | 24.1 MiB      | 46.2 MiB   |
+| Spotify | 407.3 MiB      | 592.7 MiB     | 1000.0 MiB |
+