* [gentoo-dev] Expanding categories' descriptions
@ 2013-03-31 17:29 Denis M.
2013-04-01 7:52 ` [gentoo-dev] " Michael Palimaka
0 siblings, 1 reply; 4+ messages in thread
From: Denis M. @ 2013-03-31 17:29 UTC (permalink / raw
To: gentoo-dev
[-- Attachment #1: Type: text/plain, Size: 1053 bytes --]
Hello,
(I was redirected from gentoo-doc@ to ask this here.)
I think it's a good idea to expand the categories' descriptions (found
in the corresponding metadata.xml files) with more accurate descriptions
of which packages are welcome to fit in which categories.
The current descriptions are very vague and aren't probably in the best
shape to bring users' a good idea what certain category is about and
what packages are to be found there.
This can also be an issue for (new) ebuild-writers (either
user-contributed ebuilds or just gentoo developers that are not sure
about it either).
This is of course checked by a gentoo developer if new ebuilds are to be
submitted via the bugzilla, but I still think we should provide a better
understanding of the categories.
If expanding the metadata.xml files does not seem a good idea, we should
at least make a little bit more comprehensive description somewhere in
the gentoo.org/doc/ or wiki.gentoo.org pages.
What do you think about it?
Regards,
Denis M. (Phr33d0m)
[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-dev] Re: Expanding categories' descriptions
2013-03-31 17:29 [gentoo-dev] Expanding categories' descriptions Denis M.
@ 2013-04-01 7:52 ` Michael Palimaka
2013-04-02 11:01 ` Sergey Popov
0 siblings, 1 reply; 4+ messages in thread
From: Michael Palimaka @ 2013-04-01 7:52 UTC (permalink / raw
To: gentoo-dev
On 1/04/2013 04:29, Denis M. wrote:
> Hello,
>
> (I was redirected from gentoo-doc@ to ask this here.)
>
> I think it's a good idea to expand the categories' descriptions (found
> in the corresponding metadata.xml files) with more accurate descriptions
> of which packages are welcome to fit in which categories.
>
> The current descriptions are very vague and aren't probably in the best
> shape to bring users' a good idea what certain category is about and
> what packages are to be found there.
>
> This can also be an issue for (new) ebuild-writers (either
> user-contributed ebuilds or just gentoo developers that are not sure0-000-p
> about it either).
> hat t
> This is of course checked by a gentoo developer if new ebuilds are to be
> submitted via the bugzilla, but I still think we should provide a better
> understanding of the categories.
>
> If expanding the metadata.xml files does not seem a good idea, we should
> at least make a little bit more comprehensive description somewhere in
> the gentoo.org/doc/ or wiki.gentoo.org pages.
>
> What do you think about it?
>
>
> Regards,
> Denis M. (Phr33d0m)
>
Sounds good to me. From time to time I see even experienced developers
not sure as to which category a package belongs.
There is also inconsistency with packages of a certain type being spread
over multiple categories. For example, packages containing "password
manager" in the description currently exist in three different categories.
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [gentoo-dev] Re: Expanding categories' descriptions
2013-04-01 7:52 ` [gentoo-dev] " Michael Palimaka
@ 2013-04-02 11:01 ` Sergey Popov
2013-04-05 5:33 ` Ben de Groot
0 siblings, 1 reply; 4+ messages in thread
From: Sergey Popov @ 2013-04-02 11:01 UTC (permalink / raw
To: gentoo-dev
[-- Attachment #1: Type: text/plain, Size: 2131 bytes --]
01.04.2013 11:52, Michael Palimaka пишет:
> On 1/04/2013 04:29, Denis M. wrote:
>> Hello,
>>
>> (I was redirected from gentoo-doc@ to ask this here.)
>>
>> I think it's a good idea to expand the categories' descriptions (found
>> in the corresponding metadata.xml files) with more accurate descriptions
>> of which packages are welcome to fit in which categories.
>>
>> The current descriptions are very vague and aren't probably in the best
>> shape to bring users' a good idea what certain category is about and
>> what packages are to be found there.
>>
>> This can also be an issue for (new) ebuild-writers (either
>> user-contributed ebuilds or just gentoo developers that are not
>> sure0-000-p
>> about it either).
>> hat t
>> This is of course checked by a gentoo developer if new ebuilds are to be
>> submitted via the bugzilla, but I still think we should provide a better
>> understanding of the categories.
>>
>> If expanding the metadata.xml files does not seem a good idea, we should
>> at least make a little bit more comprehensive description somewhere in
>> the gentoo.org/doc/ or wiki.gentoo.org pages.
>>
>> What do you think about it?
>>
>>
>> Regards,
>> Denis M. (Phr33d0m)
>>
>
> Sounds good to me. From time to time I see even experienced developers
> not sure as to which category a package belongs.
>
> There is also inconsistency with packages of a certain type being spread
> over multiple categories. For example, packages containing "password
> manager" in the description currently exist in three different categories.
+1 for that. I was really confused(tbh, i am confused even now) about
x11-apps/x11-misc categories, for example. Sometimes it is really not
clear where package should goes.
Another example - app-admin/ansible. Some devs thinks that it should be
sys-cluster/ansible, but i put it into app-admin/, relying on
app-admin/puppet as an example.
So, some sort of clarification for such noobs, like me, would be really
appreciated :-)
--
Best regards, Sergey Popov
Gentoo Linux Developer
Desktop-effects project lead
[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 555 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [gentoo-dev] Re: Expanding categories' descriptions
2013-04-02 11:01 ` Sergey Popov
@ 2013-04-05 5:33 ` Ben de Groot
0 siblings, 0 replies; 4+ messages in thread
From: Ben de Groot @ 2013-04-05 5:33 UTC (permalink / raw
To: gentoo-dev
[-- Attachment #1: Type: text/plain, Size: 1813 bytes --]
On 2 April 2013 19:01, Sergey Popov <pinkbyte@gentoo.org> wrote:
> 01.04.2013 11:52, Michael Palimaka пишет:
> > On 1/04/2013 04:29, Denis M. wrote:
> >> I think it's a good idea to expand the categories' descriptions (found
> >> in the corresponding metadata.xml files) with more accurate descriptions
> >> of which packages are welcome to fit in which categories.
> >>
> >> If expanding the metadata.xml files does not seem a good idea, we should
> >> at least make a little bit more comprehensive description somewhere in
> >> the gentoo.org/doc/ or wiki.gentoo.org pages.
> >>
> >> What do you think about it?
> >>
> >
> > Sounds good to me. From time to time I see even experienced developers
> > not sure as to which category a package belongs.
> >
> > There is also inconsistency with packages of a certain type being spread
> > over multiple categories. For example, packages containing "password
> > manager" in the description currently exist in three different
> categories.
>
> +1 for that. I was really confused(tbh, i am confused even now) about
> x11-apps/x11-misc categories, for example. Sometimes it is really not
> clear where package should goes.
>
> Another example - app-admin/ansible. Some devs thinks that it should be
> sys-cluster/ansible, but i put it into app-admin/, relying on
> app-admin/puppet as an example.
>
> So, some sort of clarification for such noobs, like me, would be really
> appreciated :-)
>
>
>
I agree that it is a good idea. I also tried to be explicit when I added
the dev-qt category. I'm sure we can benefit from more precise descriptions
for all categories.
So please come with some suggestions to get the ball rolling!
--
Cheers,
Ben | yngwin
Gentoo developer
Gentoo Qt project lead, Gentoo Wiki admin
[-- Attachment #2: Type: text/html, Size: 2593 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2013-04-05 5:33 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-03-31 17:29 [gentoo-dev] Expanding categories' descriptions Denis M.
2013-04-01 7:52 ` [gentoo-dev] " Michael Palimaka
2013-04-02 11:01 ` Sergey Popov
2013-04-05 5:33 ` Ben de Groot
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox