Re: Package Maintainer Docs published

2021-08-31 Thread Otto Urpelainen

Vít Ondruch kirjoitti 31.8.2021 klo 11.43:


Dne 31. 08. 21 v 7:39 Otto Urpelainen napsal(a):

Greetings,

Some months ago, I announced [0] that I will move the package 
maintainer docs from wiki to docs.fedoraproject.org.



Thx a lot.



All changes to the documentation is intended to happen through pull
requests. However, following the spirit of earlier wiki based
documentation, the documentation is intended to be maintainer
collectively by all Fedora packagers.

Due to technical issues, the packager group from Fedora Account
System cannot be granted access, so there is a separate group
package-maintainer-docs with commit access. Membership is granted to
any packager requesting it. Please file an issue in the repository if
you want to join.




Everybody whose PR was accepted should get commit bit IMO. 


So you mean that even people not in the 'packager' group would be 
granted access after they have one accepted PR? Sounds reasonable, there 
is still some minimal barrier of entry to block spam and such, and would 
help getting the parts that are relevant to new contributors fixed.


Also, it 
would probably help it there was explained how to get some attention if 
nobody responds to PR.


Yes, this is needed. Perhaps something like this: If your pull request 
is simple and you have commit rights, just merge it. If you do not have 
commit rights, or the change is not simple and really would need a 
review, notify people marked as repo admins by mentioning them in a 
comment. If that does not lead anywhere, complain in the devel list.


I suppose direct commits for trivial changes like typo fixes and broken 
links could be recommended, too.


Otto
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure


Re: Package Maintainer Docs published

2021-08-31 Thread kevin
On Tue, Aug 31, 2021 at 07:27:50AM +, Mattia Verga via devel wrote:
> Il 31/08/21 07:39, Otto Urpelainen ha scritto:
> > Greetings,
> >
> > Some months ago, I announced [0] that I will move the package maintainer
> > docs from wiki to docs.fedoraproject.org. I am happy to announce that
> > this task is complete and the docs are public in their new location now
> > [1]. Hopefully, this will allow existing and new packagers to find
> > relevant documentation more easily, and foster more concentrated efforts
> > to make it better.
> >
> Thanks for this work!
> 
> Just a question from a quick reading of the Joining the Package
> Maintainers section: now that Bugzilla is integrated with the Fedora
> Account System (we can login with that) is it still mandatory to create
> a BZ account? Or should we make new users to login in BZ with FAS
> (noggin) to have the account created in BZ? How does that work?

It would create it. However, I think we should wait on this a bit
longer. The new account system has a bugzilla account field in it.
We are close to ready to make that work as you expect (ie, if you put an
account name in there it will use that as your bugzilla login/account),
but it needs some more work with bugzilla admins before it's live. 
Right now, you just get your primary email address.

kevin


signature.asc
Description: PGP signature
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure


Re: Package Maintainer Docs published

2021-08-31 Thread Ankur Sinha
On Tue, Aug 31, 2021 10:43:26 +0200, Vít Ondruch wrote:
> 
> Everybody whose PR was accepted should get commit bit IMO. Also, it would
> probably help it there was explained how to get some attention if nobody
> responds to PR.

+1.

I've filed a tracker ticket where folks can comment if they'd like to
help maintain the docs:
https://pagure.io/fedora-docs/package-maintainer-docs/issue/23

-- 
Thanks,
Regards,
Ankur Sinha "FranciscoD" (He / Him / His) | 
https://fedoraproject.org/wiki/User:Ankursinha
Time zone: Europe/London


signature.asc
Description: PGP signature
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure


Re: Package Maintainer Docs published

2021-08-31 Thread Vít Ondruch


Dne 31. 08. 21 v 7:39 Otto Urpelainen napsal(a):

Greetings,

Some months ago, I announced [0] that I will move the package 
maintainer docs from wiki to docs.fedoraproject.org.



Thx a lot.



All changes to the documentation is intended to happen through pull
requests. However, following the spirit of earlier wiki based
documentation, the documentation is intended to be maintainer
collectively by all Fedora packagers.

Due to technical issues, the packager group from Fedora Account
System cannot be granted access, so there is a separate group
package-maintainer-docs with commit access. Membership is granted to
any packager requesting it. Please file an issue in the repository if
you want to join.




Everybody whose PR was accepted should get commit bit IMO. Also, it 
would probably help it there was explained how to get some attention if 
nobody responds to PR.



Vít
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure


Re: Package Maintainer Docs published

2021-08-31 Thread Mattia Verga via devel
Il 31/08/21 07:39, Otto Urpelainen ha scritto:
> Greetings,
>
> Some months ago, I announced [0] that I will move the package maintainer
> docs from wiki to docs.fedoraproject.org. I am happy to announce that
> this task is complete and the docs are public in their new location now
> [1]. Hopefully, this will allow existing and new packagers to find
> relevant documentation more easily, and foster more concentrated efforts
> to make it better.
>
Thanks for this work!

Just a question from a quick reading of the Joining the Package
Maintainers section: now that Bugzilla is integrated with the Fedora
Account System (we can login with that) is it still mandatory to create
a BZ account? Or should we make new users to login in BZ with FAS
(noggin) to have the account created in BZ? How does that work?

Mattia

___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure


Package Maintainer Docs published

2021-08-30 Thread Otto Urpelainen

Greetings,

Some months ago, I announced [0] that I will move the package maintainer 
docs from wiki to docs.fedoraproject.org. I am happy to announce that 
this task is complete and the docs are public in their new location now 
[1]. Hopefully, this will allow existing and new packagers to find 
relevant documentation more easily, and foster more concentrated efforts 
to make it better.


Let me explain how the docs are set up now. I worked mainly alone to get 
the actual move done. From this point on, I hope that maintenance is 
done by all package maintainers collectively, similarly to how the wiki 
documentation was under shared ownership. This also means that 
everything here is a draft, open for changes based on your feedback. 
Comments are welcome!


The imported content was selected by going through wiki category Package 
Maintainers [2] and choosing the pages that seemed useful. In general, 
the pages were imported without modification, however in some cases 
there were such serious issues that I did some editing.


Going forward, documentation for package maintainers should be added to 
this repo, instead of wiki. There is an issue for replacing the imported 
wiki pages with pointers to the new urls [3] which will be done soon. 
Policies, guidelines and other material owned by FESCo or the Packaging 
Committee is excluded from this repository and is handled like before.


One change that moving from wiki to a Git repository at pagure.io brings 
is access control. I would like to allow all members of the 'packager' 
group, but unfortunately that group is not visible at pagure.io. So 
instead I wrote this in the README, to serve as a basis for iterating a 
good solution:



All changes to the documentation is intended to happen through pull
requests. However, following the spirit of earlier wiki based
documentation, the documentation is intended to be maintainer
collectively by all Fedora packagers.

Due to technical issues, the packager group from Fedora Account
System cannot be granted access, so there is a separate group
package-maintainer-docs with commit access. Membership is granted to
any packager requesting it. Please file an issue in the repository if
you want to join.


If you have any interest in the docs at all, I hope you file an issue 
for membership, or just reply to this mail and I will add you.


Currently, I am the maintainer of the repository. There are four other 
people listed as admins: pingou, mattdm, kevin, codeblock. This list of 
a leftover from an older, unpublished iteration of the docs. To my 
understanding, none of these people have expressed interest in 
maintaining the repository, for whatever tasks there may be that cannot 
be handled by the committer group. So, I plan to remove everybody but 
myself. Naturally, to avoid non-responsive admins situation, there 
should be more than one admin. If you are interested, please let me know 
an I will add you.


Otto

[0]: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/message/4UPDUFVHULLELBKSOYJ233WU3E4BCGYI/

[1]: https://docs.fedoraproject.org/en-US/package-maintainers/
[2]: https://fedoraproject.org/wiki/Category:Package_Maintainers
[3]: https://pagure.io/fedora-docs/package-maintainer-docs/issue/20
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure