basic principles documentation improved