[gentoo-dev] Expanding categories' descriptions

[gentoo-dev] Expanding categories' descriptions

[Denis M.]

[-- 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 --]

[gentoo-dev] Re: Expanding categories' descriptions

[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.

Re: [gentoo-dev] Re: Expanding categories' descriptions

[Sergey Popov]

[-- 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 --]

Re: [gentoo-dev] Re: Expanding categories' descriptions

[Ben de Groot]

[-- 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 --]