doc: general refactoring and improvements