Gentoo Archives: gentoo-dev

From: Alec Warner <antarus@g.o>
To: Gentoo Dev <gentoo-dev@l.g.o>
Cc: glep@g.o
Subject: Re: [gentoo-dev] [PATCH 0/1] Add 'notes' element to metadata.xml (GLEP 68)
Date: Tue, 05 Oct 2021 21:21:39
Message-Id: CAAr7Pr-MQN6LpkiqY1rXh0gMoW+7uFawMKOASeSiRprqxfqpcg@mail.gmail.com
In Reply to: Re: [gentoo-dev] [PATCH 0/1] Add 'notes' element to metadata.xml (GLEP 68) by Sam James
1 On Tue, Oct 5, 2021 at 1:36 PM Sam James <sam@g.o> wrote:
2 >
3 >
4 >
5 > > On 5 Oct 2021, at 21:29, Alec Warner <antarus@g.o> wrote:
6 > >
7 > > I thought we were going to go with the github-pages type route
8 > > (markdown, rendered online or locally.)
9 > >
10 >
11 > So, the thinking was, we could allow somewhat shorthand
12 > notes or for the people who want to invest more time, allow
13 > the GitHub-pages type route.
14 >
15 > But I'm open to the idea of just recommending people
16 > use that if there's no appetite for mixed types.
17
18 I'd argue we can add NOTES.md to packages (e.g. allow those files.)
19 Then we modify packages.gentoo.org to render the markdown; or users
20 can render locally or read unrendered.
21
22 WDYT?
23
24 -A
25
26 >
27 > > -A
28 > >
29 > > On Tue, Oct 5, 2021 at 11:28 AM Sam James <sam@g.o> wrote:
30 > >>
31 > >> This is a preliminary version/draft of a proposed change to
32 > >> GLEP 68.
33 > >>
34 > >> I'd like to introduce a method for developers to signal anything
35 > >> special about a package and how to correctly maintain it.
36 > >>
37 > >> Sam James (1):
38 > >> glep-0068: Add notes element for package maintenance instructions
39 > >>
40 > >> glep-0068.rst | 26 +++++++++++++++++++++++---
41 > >> 1 file changed, 23 insertions(+), 3 deletions(-)
42 > >>
43 > >> --
44 > >> 2.33.0
45 > >>
46 > >>
47 > >
48 >

Replies