On 12/18/2015 10:19 AM, H. S. Teoh via Digitalmars-d wrote:
On Thu, Dec 17, 2015 at 06:50:34PM -0500, Andrei Alexandrescu via Digitalmars-d
wrote:
[...]
* "Examples:" is a historical error. All instances should be "Example:".
Just one diff making that change throughout would be a meaningful
contribution.
[...]
I'm pretty sure ddoc'd unittests show up as "Examples:". Or was this
changed recently?
It should get changed to singular because it's grammatically incorrect.
Most examples shown feature exactly one instance of using the
demonstrated artifact. So it's incorrect to write "Examples:" followed
by one example.
Conversely, if there are multiple uses of the discussed artifact, then
"Example:" is not incorrect - it's one example featuring several uses.
Andrei
