Complete Getting Started Tutorials

[markus2330]

Create "Getting Started Tutorials" to be linked on main page:

• error handling (how to set/add errors/warnings)
• how to work with types in Elektra (+ guarantees if C99) + elektraKeyTo* by @eiskasten
• merging, how to use KDB (get/state states, conflict handling, tools vs. importing) by @hannes99
• how to work with spec+metadata (link to doc/METADATA.ini)
• how to disable mmap @mpranj
• how to report bugs (kdb stash/restore), shell recorder, ..
• basic tutorial with kdb mount, qt-gui, import, export (done for LCDproc)
• bindings
• get started with language bindings: lua/java/c++
• how to use "plugins"
• mount tutorial (basic tutorial with kdb)
• get started with namespaces and cascading lookup (starting with /)

Further ideas, see #1522

[markus2330]

And add:

• working with envvars (libelektra-getenv) @omnidan

[omnidan]

I would like to add envvars as a short example directly in the Usage section. (instead of the current example which isn't all that useful) Then we could link to a separate page which explains it further.

[markus2330]

@omnidan nice, maybe it can be used for release notes, too

[petermax2]

are you working on this?

@markus2330 yes I was going to!

[markus2330]

was going to OR am going to?

Manuel already has finished his MinGW task. I hope #273 gets resolved soon too. Every push request for improvement of docu received before #273 is resolved, can make it into the release.

[petermax2]

Alright, I hope I get it done by the end of the day.

[petermax2]

@markus2330 how would a tutorial about namespaces differ from doc/NAMESPACES.md?

[petermax2]

My pull request #285 has been merged.

[markus2330]

Yes, I forgot to mark this issue here.

[markus2330]

Still open is:

• get started with python/lua/java/c++
• get started with spec+metadata (link to doc/METADATA.ini)
• get started with envvars (libelektra-getenv) @omnidan
• get started with some plugins?

[omnidan]

get started with envvars is done in the main README.md with a link to more information

[markus2330]

Still open is:

• get started with python/lua/java/c++
• get started with spec+metadata (link to doc/METADATA.ini)
• get started with some plugins?