| 1 |
On 2017-11-27 10:54, Duncan wrote: |
| 2 |
> Ulrich Müller posted on Mon, 27 Nov 2017 00:30:49 +0100 as excerpted: |
| 3 |
> |
| 4 |
> > diff --git a/glep-0042.rst b/glep-0042.rst |
| 5 |
> > index 7726ea4..90ae0b2 100644 |
| 6 |
> > --- a/glep-0042.rst |
| 7 |
> > +++ b/glep-0042.rst |
| 8 |
> > @@ -179,7 +179,9 @@ form ``yyyy-mm-dd-short-name``, where ``yyyy`` is the year (e.g. ``2005``), |
| 9 |
> > ``mm`` is the month (``01`` through ``12``) and dd is the day of the month |
| 10 |
> > (``01`` through ``31``). The ``short-name`` is a very short name describing the |
| 11 |
> > news item (e.g. ``yoursql-updates``), consisting only of the characters ``a-z``, |
| 12 |
> > -``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). |
| 13 |
> > +``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). While there |
| 14 |
> > +is no hard restriction for the length of ``short-name``, it is strongly |
| 15 |
> > +recommended to limit it to at most 20 characters. |
| 16 |
> |
| 17 |
> Arguably bikeshedding but changing up the last sentence to read a bit smoother |
| 18 |
> (I skipped formatting)... |
| 19 |
> |
| 20 |
> While there is no hard restriction on the length of short-name, |
| 21 |
> limiting it to 20 characters is strongly recommended. |
| 22 |
> |
| 23 |
> (s/for/on/, reversing order of the limit and strongly recommended.) |
| 24 |
|
| 25 |
I agree. This one reads a bit better. |
| 26 |
|
| 27 |
Does it matter if people notice the recommendation? Should it be its own |
| 28 |
paragraph for emphasis? |
Archives