documentation: content improvements