Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 569324 - Documentation Translation projects reuse the same e-mail address
Summary: Documentation Translation projects reuse the same e-mail address
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Infrastructure
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Wiki Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: glep67-tracker
  Show dependency tree
 
Reported: 2015-12-23 13:45 UTC by Michał Górny
Modified: 2022-08-23 19:08 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2015-12-23 13:45:48 UTC
Per GLEP67 every project should have an unique e-mail address. Right now the projects listed in summary share the same address. Please let me know if and what new aliases you'd like to get for the projects.

Furthermore, gentoo-doc@ is not even registered on Bugzilla.
Comment 1 Matthew Marchese Gentoo Infrastructure gentoo-dev 2016-01-26 06:54:02 UTC
I think gentoo-doc@gentoo.org would be great for this, Michał. I may be the only member of the doc team who is active...
Comment 2 Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2016-01-31 08:04:53 UTC
(In reply to Matthew Marchese from comment #1)
> I think gentoo-doc@gentoo.org would be great for this, Michał. I may be the
> only member of the doc team who is active...

Err, what do you exactly want me to do here? Create a Bugzilla account for this alias?
Comment 3 nm (RETIRED) gentoo-dev 2016-02-06 07:23:49 UTC
given how small the docs project and translation subprojects are (at times just 1-2 total staff)...what do you want us to do for this GLEP?
Comment 4 Göktürk Yüksek archtester gentoo-dev 2016-02-06 07:30:39 UTC
(In reply to Josh Saddler from comment #3)
> given how small the docs project and translation subprojects are (at times
> just 1-2 total staff)...what do you want us to do for this GLEP?

Without a bugzilla acccount for the project, we cannot assign bugs to gentoo-doc@gentoo.org properly.
Comment 5 nm (RETIRED) gentoo-dev 2016-02-06 07:49:48 UTC
(In reply to Gokturk Yuksek from comment #4)
> (In reply to Josh Saddler from comment #3)
> > given how small the docs project and translation subprojects are (at times
> > just 1-2 total staff)...what do you want us to do for this GLEP?
> 
> Without a bugzilla acccount for the project, we cannot assign bugs to
> gentoo-doc@gentoo.org properly.

we don't use that address. bugs have always been assigned to docs-team@g.o -- they're not supposed to be assigned to gentoo-doc@. where did you get that idea?
Comment 6 Göktürk Yüksek archtester gentoo-dev 2016-02-06 07:58:30 UTC
(In reply to Josh Saddler from comment #5)
> (In reply to Gokturk Yuksek from comment #4)
> > (In reply to Josh Saddler from comment #3)
> > > given how small the docs project and translation subprojects are (at times
> > > just 1-2 total staff)...what do you want us to do for this GLEP?
> > 
> > Without a bugzilla acccount for the project, we cannot assign bugs to
> > gentoo-doc@gentoo.org properly.
> 
> we don't use that address. bugs have always been assigned to docs-team@g.o
> -- they're not supposed to be assigned to gentoo-doc@. where did you get
> that idea?

GLEP 67 specifies:
  <email/> element stating the project contact e-mail (must be registered on bugs.gentoo.org)
The documentation project wiki page (https://wiki.gentoo.org/wiki/Project:Documentation) reports the project contact email as gentoo-doc@gentoo.org.
I think per GLEP 67, the docs project is required to have a bugzilla account associated with the email address 'gentoo-doc@gentoo.org'. mgorny can correct me if I'm wrong.

It also specifies that "all existing projects must be ensured to have unique e-mail addresses. Projects sharing the same e-mail address either need to be merged, or be given unique e-mail addresses." So I think the translation project cannot reuse 'gentoo-doc@gentoo.org'.
Comment 7 Adam Feldman gentoo-dev 2016-02-06 08:32:47 UTC
If I may make a few suggestions, we encountered similar issues with the BSD project.

Firstly, the issue at the core of the bug is that Project:Documentation and Project:Documentation Translation share the same email, gentoo-doc@gentoo.org.  We handled this in BSD by putting the users from the subprojects into the parent's alias, and then removed the email from the subprojects.  That makes it square with GLEP 67.

The next issue is that there are two emails in contention here, gentoo-doc and docs-team.   These should be consolidated as they are both for the same project.  As there is another related bugzilla alias gentoo-doc-review, and the fact that gentoo-doc, IMO, meshes with the namespace better, docs-team should be merged into gentoo-doc, both the alias, and on bugzilla.

That should resolve all of the issues with GLEP 67 and the disparity between registered email aliases and bugzilla.

Let me know if you have any questions about the setup.
Comment 8 Adam Feldman gentoo-dev 2016-02-06 08:43:36 UTC
(In reply to Josh Saddler from comment #5)
> we don't use that address. bugs have always been assigned to docs-team@g.o
> -- they're not supposed to be assigned to gentoo-doc@. where did you get
> that idea?

It appears that the project was updated to gentoo-doc in 2013 by swift https://wiki.gentoo.org/index.php?title=Project:Documentation&diff=prev&oldid=60243 unless you guys wanted some separation between bugzilla and the project itself that, as an outsider, I would be unaware of.
Comment 9 Matthew Marchese Gentoo Infrastructure gentoo-dev 2016-03-03 00:21:09 UTC
I fixed the first issue via the same method used to resolve the BSD project per NP's suggestion. The documentation project team now inherits the members of the translation team and the e-mail address has been from the wiki page since it matched anyway.

As for the Bugzilla and aliases, I'll need to discuss with SwifT first.
Comment 10 Matthew Marchese Gentoo Infrastructure gentoo-dev 2016-03-03 00:21:52 UTC
*has been removed from the wiki page.
Comment 11 Göktürk Yüksek archtester gentoo-dev 2017-04-12 15:24:27 UTC
Is this bug still valid, doesn't seem like so to me?
Comment 12 Matthew Marchese Gentoo Infrastructure gentoo-dev 2018-01-23 00:02:22 UTC
The old documentation project is defunct. It no longer exists as it and its members has been merged into the handbook project (which does not currently have a mail alias, to the best of my knowledge.

The same is true for the "Translations" project. Translation of the various handbooks are now handled by the handbook project members, which are a subset of the wiki project.

https://wiki.gentoo.org/wiki/Project:Wiki

All mail aliases coordinating to gentoo-docs or gentoo-translators can be removed (if they exist).
Comment 13 Matthew Marchese Gentoo Infrastructure gentoo-dev 2022-08-23 19:08:24 UTC
Nothing left to do here. As noted in comment #12, the Translations project has been rolled into the wiki project (because - as far as I know - translations are not available anywhere else across the Gentoo ecosystem... Portage, www.g.o, devmanual.g.o, packages.g.o, etc. do not have translations available). We should probably just admit that, in order to use Gentoo, our community members at least need a basic level of understanding English.

The Gentoo documentation project members have been merged into the Handbook. This is for two reasons:

1) All Gentoo GuideXML have been migrated onto the wiki or deprecated circa 2016.
2) Handbook is the primary document maintained by the Gentoo docs project since most other documents are now in Project: namespace on the wiki (project members responsible for maintaining their own docs, not the wiki team).