docs: restructure and rewrite adapting to new structure

Incresased the level of specifity and removed redunancies.
ui: sync with docs