3diy
/
klipper
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Improve documentation for those starting in docs/ 

Those that reach Klipper via github may jump directly to the docs/
directory in search of documentation.  Add README.md and rework
Overview.md with that in mind.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2017-04-27 15:31:48 -04:00
parent c1c0b2dd38
commit a7f339ad1c
3 changed files with 30 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/Installation.md
View File

@ -58,8 +58,8 @@ Finally, for common micro-controllers, the code can be flashed with:
make flash FLASH_DEVICE=/dev/ttyACM0 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 The Klipper configuration is stored in a text file on the Raspberry
Pi. Take a look at the example config files in the Pi. Take a look at the example config files in the

40
docs/Overview.md
View File

@ -1,21 +1,33 @@
See [installation](Installation.md) for information on compiling, Welcome to the Klipper documentation. There are two parts to Klipper -
installing, and running Klipper. Read [features](Features.md) for a code that runs on a micro-controller and code that runs on a "host"
high-level description of useful capabilities. The history of releases machine. The host code is intended to run on a low-cost
is available at [releases](Releases.md). 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 The Klipper configuration is stored in a simple text file on the host
information on tuning the pressure advance system. The machine. The [config/example.cfg](../config/example.cfg) file serves
[kinematics](Kinematics.md) document provides high level information as a reference for the config file. The
on how movement is implemented in Klipper. [Pressure Advance](Pressure_Advance.md) document contains information
on tuning the pressure advance config.
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).
Developer Documentation
=======================
There are also several documents available for developers interested There are also several documents available for developers interested
in understanding how Klipper works: 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 [code overview](Code_Overview.md) for information on the structure See [protocol](Protocol.md) for information on the low-level messaging
and layout of the Klipper code. protocol between host and micro-controller. See also
See [protocol](Protocol.md) for information on the messaging protocol
between host and micro-controller. See also
[MCU commands](MCU_Commands.md) for a description of low-level [MCU commands](MCU_Commands.md) for a description of low-level
commands implemented in the micro-controller software. commands implemented in the micro-controller software.

2
docs/README.md Normal file
View File

@ -0,0 +1,2 @@
Welcome to the Klipper documentation. The
[overview document](Overview.md) is a good starting point.