docs: Many clarifiations and fixes for consistency