Commits on Feb 2, 2023

  1. spec: Fix a trailing comma at the end of a paragraph 

    Signed-off-by: Philip Withnall <pwithnall@endlessos.org>
    @pwithnall
    pwithnall committed Feb 2, 2023
    5b5ca99

  2. spec: Expand documentation for <issue> elements 

    Try and make it a bit clearer what formats are expected, and when URLs
are expected to be given. What was there before was not incorrect, but
was a bit hard to unpack.

Add a couple more examples inline.

Signed-off-by: Philip Withnall <pwithnall@endlessos.org>

Fixes: ximion#458
    @pwithnall
    pwithnall committed Feb 2, 2023
    565bace

  3. spec: Mention that <issues> is not part of the description 

    Given that it’s typically written right after the `<description>`
element, there’s a temptation to think that it will be presented right
after the prose in the description. But that’s not necessarily the case.

Signed-off-by: Philip Withnall <pwithnall@endlessos.org>

Helps: ximion#458
    @pwithnall
    pwithnall committed Feb 2, 2023
    a1d3fd1

  4. spec: Give some guidance about tone in release descriptions 

    Signed-off-by: Philip Withnall <pwithnall@endlessos.org>

Helps: ximion#458
    @pwithnall
    pwithnall committed Feb 2, 2023
    531dd14