doc: fix a sphinx build warning
doc: restructure documentation with better grouping, improve cross-refs