Organize the repo to ease the onboarding of new members about sharing-creates-value HOT 7 OPEN

I recommend to do the same as many OSS projects - create docs/getting-started as an onboarding guide for this project. I know we are now using a wiki which has a benefits that there easy editable the down side of GitHub wiki is that you can't collaborate easily on them as with commits and pull request discussions.

Should we continue using a GitHub wiki or switch to plain MarkDown files in /docs folder in the repository?

from sharing-creates-value.

Asciidoc or reStructuredText? Markdown is somehow not mature enough for a document and everybody who can write Markdown can write Asciidoc. reStructuredText requires a solid start and a bit of learning.

from sharing-creates-value.

In my opinion it is better to have everything in one place, for different reasons like maintainability, completeness and so on. Although I like wikis I think it is better to move the current wiki content to the repo itself.

from sharing-creates-value.

from sharing-creates-value.

Wikis are where information goes to die. +1 to @OliverFendt's suggestion to keep everything in one place, and to his stated reasons. Fractured information is lost information,

from sharing-creates-value.

Ok fine it seems that we have consensus to move the information from the wiki to the repo and shut down the wiki.
What else shall we do - reorg the repo?

from sharing-creates-value.

with the PR #90 it is now time to continue in reorganizing the repo

from sharing-creates-value.