Skip to content

Commit 1348b72

Browse files
committed
Update README.md
cf. skonfig/.github#10
1 parent 3bbe3f2 commit 1348b72

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

README.md

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,29 @@
11
# skonfig base set
22

3-
[skonfig](https://skonfig.li) is a configuration management system forked from [cdist](https://cdi.st)
4-
(after [e250024](https://code.ungleich.ch/ungleich-public/cdist/commit/e2500248f2ddc83129e77f2e6b8dffb64904dbae)).
3+
[skonfig](https://skonfig.li) is a system configuration and automation framework
4+
designed to work with all systems, from your toaster to the data centre.
55

6-
We have three main repositories:
6+
skonfig uses three main repositories:
77

8-
* [skonfig](https://github.com/skonfig/skonfig) - implementation of the **skonfig tool** and quick **getting started** bits,
8+
* [skonfig](https://github.com/skonfig/skonfig) - implementation of the **skonfig** executable,
99
* **base** - explorer and types for **general use**,
1010
* [extra](https://github.com/skonfig/extra) - **special purpose** types and incubator for new types.
1111

12-
You can find us in `#skonfig:matrix.org` ([matrix?](https://matrix.org/faq/)).
12+
Check out the [skonfig](https://github.com/skonfig/skonfig) repository to learn
13+
how to get started.
14+
15+
**Need support?** You can find us in `#skonfig:matrix.org` ([matrix?](https://matrix.org/faq/)).
1316

1417
## Documentation
1518

16-
Most parts of [cdist documentation](https://www.cdi.st/manual/latest/) apply, but there are differences:
19+
Most parts of the [cdist documentation](https://www.cdi.st/manual/latest/) still
20+
apply, but there are some differences:
1721

1822
* `skonfig` does only `config` (see `skonfig -h`),
19-
* some types behave differently and it's recommended to consult manuals in *base* and *extra*.
23+
* some types behave differently and it's recommended to consult the `man.rst`
24+
files in *base* and *extra*.
2025

21-
## Split between *base* and *extra*
26+
## What are *base* and *extra*?
2227

2328
**Base** explorers and types are used to change the state of the operating
2429
system or core components of it and are not for some specific piece of
@@ -28,3 +33,9 @@ higher than for extra.
2833
**Extra** contains types for specific purposes like configuring software or
2934
services which don't belong to the operating system and also serves as an
3035
incubator for new types.
36+
37+
Even more types can be found in sets specialised in helping you configure a
38+
specific piece of software. Some of these sets can be found in this organization.
39+
40+
And being a fork of [cdist](https://cdis.st/) originally, your cdist manifests
41+
and types will continue to work with skonfig with no or minimal adjustments.

0 commit comments

Comments
 (0)