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