Update documentation

[mogres]

The current documentation in docs is very outdated. The markdown files in this folder should be updated to reflect changes in installation and recipe schema.

[meganrm]

this may be a few separate PRs/subtasks, but we should make sure the docs are up to date