doc(smith): fix, clarify

Pascal Engélibertrequested to merge
tuxmain-smith-doc into master

Merge request reports