Merge pull request skonfig#145 from riiengineering/update-readme

Update README.md

Author: 4nd3r

README.md

@@ -1,24 +1,32 @@
 # skonfig base set
 
-[skonfig](https://skonfig.li) is a configuration management system forked from [cdist](https://cdi.st)
-(after [e250024](https://code.ungleich.ch/ungleich-public/cdist/commit/e2500248f2ddc83129e77f2e6b8dffb64904dbae)).
+[skonfig](https://skonfig.li) is a system configuration and automation framework
+designed to work with all systems, from your toaster to the data centre.
 
-We have three main repositories:
+skonfig uses three main repositories:
 
-* [skonfig](https://github.com/skonfig/skonfig) - implementation of the **skonfig tool** and quick **getting started** bits,
+* [skonfig](https://github.com/skonfig/skonfig) - implementation of the **skonfig** executable,
 * **base** - explorer and types for **general use**,
 * [extra](https://github.com/skonfig/extra) - **special purpose** types and incubator for new types.
 
-You can find us in `#skonfig:matrix.org` ([matrix?](https://matrix.org/faq/)).
+Check out the [skonfig](https://github.com/skonfig/skonfig) repository to learn
+how to get started.
+
+**Need support?** You can find us in `#skonfig:matrix.org` ([matrix?](https://matrix.org/faq/)).
 
 ## Documentation
 
-Most parts of [cdist documentation](https://www.cdi.st/manual/latest/) apply, but there are differences:
+Most parts of the [cdist documentation](https://www.cdi.st/manual/latest/) still
+apply, but there are some differences:
 
 * `skonfig` does only `config` (see `skonfig -h`),
-* some types behave differently and it's recommended to consult manuals in *base* and *extra*.
+* types are managed in sets (like this one),
+* type manifests can be a directory of scripts,
+* `gencode-*` can be a directory of scripts,
+* some types behave differently and it's recommended to consult the `man.rst`
+  files in *base* and *extra*.
 
-## Split between *base* and *extra*
+## What are *base* and *extra*?
 
 **Base** explorers and types are used to change the state of the operating
 system or core components of it and are not for some specific piece of
@@ -28,3 +36,9 @@ higher than for extra.
 **Extra** contains types for specific purposes like configuring software or
 services which don't belong to the operating system and also serves as an
 incubator for new types.
+
+Even more types can be found in sets specialised in helping you configure a
+specific piece of software. Some of these sets can be found in this organization.
+
+And being a fork of [cdist](https://cdis.st/) originally, your cdist manifests
+and types will continue to work with skonfig with no or minimal adjustments.