docs: Add an introductory paragraph to the quick start guide
This commit is contained in:
@@ -28,8 +28,8 @@ Please read, enjoy and help improve our documentation!
|
|||||||
|
|
||||||
| documentation | additional notes |
|
| documentation | additional notes |
|
||||||
|---|---|
|
|---|---|
|
||||||
| [quick start guide](docs/quick-start-guide.md) | for mgmt newcomers |
|
|
||||||
| [general documentation](docs/documentation.md) | for everyone |
|
| [general documentation](docs/documentation.md) | for everyone |
|
||||||
|
| [quick start guide](docs/quick-start-guide.md) | for mgmt developers |
|
||||||
| [resource guide](docs/resource-guide.md) | for mgmt developers |
|
| [resource guide](docs/resource-guide.md) | for mgmt developers |
|
||||||
| [godoc API reference](https://godoc.org/github.com/purpleidea/mgmt) | for mgmt developers |
|
| [godoc API reference](https://godoc.org/github.com/purpleidea/mgmt) | for mgmt developers |
|
||||||
| [puppet guide](docs/puppet.md) | for puppet sysadmins |
|
| [puppet guide](docs/puppet.md) | for puppet sysadmins |
|
||||||
|
|||||||
@@ -27,12 +27,21 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|||||||
|
|
||||||
####Table of Contents
|
####Table of Contents
|
||||||
|
|
||||||
|
0. [Introduction](#introduction)
|
||||||
1. [Dependencies](#dependencies)
|
1. [Dependencies](#dependencies)
|
||||||
2. [Quick start](#quick-start)
|
2. [Quick start](#quick-start)
|
||||||
3. [Examples](#examples)
|
3. [Examples](#examples)
|
||||||
4. [Installation](#installation)
|
4. [Installation](#installation)
|
||||||
5. [Authors - Authors and contact information](#authors)
|
5. [Authors - Authors and contact information](#authors)
|
||||||
|
|
||||||
|
## Introduction:
|
||||||
|
This guide is intended for developers. Once `mgmt` is minimally viable, we'll
|
||||||
|
publish a quick start guide for users too. In the meantime, please contribute!
|
||||||
|
If you're brand new to `mgmt`, it's probably a good idea to start by reading the
|
||||||
|
[introductory article](https://ttboj.wordpress.com/2016/01/18/next-generation-configuration-mgmt/)
|
||||||
|
or to watch an [introductory video](https://github.com/purpleidea/mgmt/#on-the-web).
|
||||||
|
Once you're familiar with the general idea, please start hacking...
|
||||||
|
|
||||||
## Dependencies:
|
## Dependencies:
|
||||||
Software projects have a few different kinds of dependencies. There are _build_
|
Software projects have a few different kinds of dependencies. There are _build_
|
||||||
dependencies, _runtime_ dependencies, and additionally, a few extra dependencies
|
dependencies, _runtime_ dependencies, and additionally, a few extra dependencies
|
||||||
|
|||||||
Reference in New Issue
Block a user