Some feedback on the website.

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Fri Dec 18 07:50:32 PST 2015


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



More information about the Digitalmars-d mailing list