Grammatical inconsistencies in the documentation

[Armavica]

The example of the std::num module speaks for itself. I can count at least three grammatical forms among the function descriptions:

• indicative form (abs: Computes the absolute value.);
• imperative form (acos: Compute the arccosine of the number.);
• noun phrase (abs_sub: The positive difference of two numbers. or cos: Cosine function).

The various style guides (https://github.com/mozilla/rust/wiki/Note-style-guide, https://github.com/mozilla/rust/wiki/Doc-using-rustdoc and http://static.rust-lang.org/doc/master/rustdoc.html) recommend writing "sentences that begin with capital letters and end in a period" but do not mention how the sentences should be formed.

I am willing to work on making all this coherent but a convention should be fixed first.

[Armavica]

Indeed, this is a duplicate of #4361, sorry.
Currently the descriptive form seems to have a small lead over the imperative form in the doc, I also personally find it more natural.

[kud1ing]

Thanks for searching. I've transfered my comments to that issue.

[gereeter]

If this is a duplicate, should it be closed?

[steveklabnik]

Yes, it should be closed as a duplicate.