docs: some clarifications and fixes

Commit

7 years ago

docs: some clarifications and fixes (cherry picked from commit ed861704bcd1494737ab710b35dfd797f51fc902)