aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/Installation.md4
-rw-r--r--docs/Overview.md40
-rw-r--r--docs/README.md2
3 files changed, 30 insertions, 16 deletions
diff --git a/docs/Installation.md b/docs/Installation.md
index 0b9c6bc6..5bec93b0 100644
--- a/docs/Installation.md
+++ b/docs/Installation.md
@@ -58,8 +58,8 @@ Finally, for common micro-controllers, the code can be flashed with:
make flash FLASH_DEVICE=/dev/ttyACM0
```
-Setting up the printer configuration
-====================================
+Configuring Klipper
+===================
The Klipper configuration is stored in a text file on the Raspberry
Pi. Take a look at the example config files in the
diff --git a/docs/Overview.md b/docs/Overview.md
index 813cff6a..759805ac 100644
--- a/docs/Overview.md
+++ b/docs/Overview.md
@@ -1,21 +1,33 @@
-See [installation](Installation.md) for information on compiling,
-installing, and running Klipper. Read [features](Features.md) for a
-high-level description of useful capabilities. The history of releases
-is available at [releases](Releases.md).
+Welcome to the Klipper documentation. There are two parts to Klipper -
+code that runs on a micro-controller and code that runs on a "host"
+machine. The host code is intended to run on a low-cost
+general-purpose machine such as a Raspberry Pi, while the
+micro-controller code is intended to run on commodity micro-controller
+chips. Read [features](Features.md) for reasons to use Klipper. See
+[installation](Installation.md) to get started with Klipper.
-See the [Pressure Advance](Pressure_Advance.md) document for
-information on tuning the pressure advance system. The
-[kinematics](Kinematics.md) document provides high level information
-on how movement is implemented in Klipper.
+The Klipper configuration is stored in a simple text file on the host
+machine. The [config/example.cfg](../config/example.cfg) file serves
+as a reference for the config file. The
+[Pressure Advance](Pressure_Advance.md) document contains information
+on tuning the pressure advance config.
-There are also several documents available for developers interested
-in understanding how Klipper works:
+The [kinematics](Kinematics.md) document provides some technical
+details on how Klipper implements motion.
+
+The history of Klipper releases is available at
+[releases](Releases.md).
-See [code overview](Code_Overview.md) for information on the structure
-and layout of the Klipper code.
+Developer Documentation
+=======================
+
+There are also several documents available for developers interested
+in understanding how Klipper works. Start with the
+[code overview](Code_Overview.md) document - it provides information
+on the structure and layout of the Klipper code.
-See [protocol](Protocol.md) for information on the messaging protocol
-between host and micro-controller. See also
+See [protocol](Protocol.md) for information on the low-level messaging
+protocol between host and micro-controller. See also
[MCU commands](MCU_Commands.md) for a description of low-level
commands implemented in the micro-controller software.
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..d3ef1484
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,2 @@
+Welcome to the Klipper documentation. The
+[overview document](Overview.md) is a good starting point.