PR#138: Update council docs for Discourse (and Matrix, while I'm at it) - Fedora-Council/council-docs

		`@@ -1,22 +1,62 @@`
		`= Contacting the Fedora Council`

		`- The Fedora Council uses two mailing lists.`
		`+ == Discussions`

		`- https://discussion.fedoraproject.org/c/project/council-discuss/60[Council Discussion] is a public category on Fedora Discussion.`
		`- This is the main discussion point for the Fedora Council,`
		`- and the goal of the is to either reach a decision,`
		`- or to delegate the thread to a more appropriate location.`
		`+ The`
		`+ https://discussion.fedoraproject.org/tag/council[#council tag]`
		`+ on`
		`+ https://discussion.fedoraproject.org/[Fedora Discussion]`
		`+ is the primary space`
		`+ for Fedora Council conversations.`
		`+ We use this for discussion within the Council as a team,`
		`+ and it is also the best place`
		`+ for any community member`
		`+ to engage in or start`
		`+ a conversation with us.`

		`- https://lists.fedoraproject.org/admin/lists/council-private@lists.fedoraproject.org/[council-private] is a private list. Its membership is restricted to the current Council members,`
		`+ We also have a private mailing list:`
		`+ https://lists.fedoraproject.org/admin/lists/council-private@lists.fedoraproject.org/[council-private].`
		`+ Its membership is restricted`
		`+ to the current Council members,`
		`and it is not archived.`
		`- This list is only used for topics that cannot be discussed on the public forum.`
		`+ This list is only used`
		`+ for topics that cannot be discussed`
		`+ on the public forum.`
		`+ We use it as little as possible.`

		`- Council members are also often present on the https://matrix.to/#/#council:fedoraproject.org[#council] channel on chat.fedoraproject.org`
		`- (briged to the #fedora-council IRC channel on https://libera.chat/[Libera.Chat]).`
		`+ == Real-Time Conversation`

		`- If you have an issue to be worked on by the Council you can also open a`
		`- ticket on the https://pagure.io/Fedora-Council/tickets[Council Pagure`
		`- instance]. This is a public issue tracker. However, if you have a`
		`- particularly privacy- or security-sensitive issue, you can check the`
		`- Private box when you create the ticket. If an issue is not sensitive`
		`- the discussion should be in the open, in the public Pagure instance or Discussion.`
		`+ Council members are also often present on the`
		`+ https://matrix.to/#/#council:fedoraproject.org?web-instance%5Belement.io%5D=chat.fedoraproject.org[#council]`
		`+ room on`
		`+ https://chat.fedoraproject.org[Fedora Chat].`
		`+ (This room is bridged to the`
		`+ #fedora-council IRC channel on`
		`+ https://libera.chat/[Libera.Chat]).`
		`+`
		`+`
		`+ == Issues`
		`+`
		`+ It's usually best to start with a conversation on`
		`+ https://discussion.fedoraproject.org/tag/council[Fedora Discussion].`
		`+`
		`+ Once you have a specific proposal`
		`+ for the Council`
		`+ you can open a ticket on the`
		`+ https://pagure.io/Fedora-Council/tickets[Council Pagure instance].`
		`+`
		`+ This is a public issue tracker.`
		`+ However, if you have a`
		`+ particularly privacy- or security-sensitive issue,`
		`+ you can check the`
		`+ Private box when you create the ticket.`
		`+ If an issue is not sensitive`
		`+ the discussion should be in the open.`
		`+`
		`+ Note that ticket comments should be`
		`+ kept to a minimum —`
		`+ discussion should be at`
		`+ https://discussion.fedoraproject.org/tag/council[#council]`
		`+ and the ticket used to`
		`+ record procedural actions`
		`+ like votes and approved resolutions.`

council/modules/ROOT/pages/fpl.adoc

file modified

+11 -6

		`@@ -6,18 +6,23 @@`
		`The FPL chairs the Fedora xref:index.adoc[Council].`

		`image::mattdm-2014-fedora10y-thumb.jpg[float="right",50%,link="https://fedoraproject.org/w/uploads/e/e8/Mattdm-2014-fedora10y-small.jpg"]`
		`- https://fedoraproject.org/wiki/User:mattdm[Matthew Miller] is the current Fedora Project Leader.`
		`+ https://mattdm.org/[Matthew Miller]`
		`+ is the current Fedora Project Leader.`
		`He led the Fedora.next initiative for a strategic approach to Fedora's second decade,`
		`as well as the transition from the Fedora Board to the current Council governance model.`
		`Matthew created the BU Linux distribution for Boston University in 1999 and maintained that through 2008,`
		`when he moved to the Harvard School of Engineering and Applied Sciences to work on high performance computing and this up-and-coming “cloud” thing.`
		`He has been at Red Hat since 2012, first working on Fedora Cloud and becoming FPL in June, 2014.`

		- Contact Matthew as `mattdm` on Libera.Chat IRC,
		`- as https://twitter.com/mattdm[@mattdm] on Twitter, or`
		`- on the`
		`- https://lists.fedoraproject.org/archives/list/council-discuss@lists.fedoraproject.org/[Council-Discuss]`
		`- mailing list.`
		`+ Contact Matthew as`
		`+ https://matrix.to/#/@mattdm:fedora.im[@mattdm:fedora.im]`
		`+ on Matrix,`
		`+ as`
		`+ https://twitter.com/mattdm[@mattdm]`
		`+ on Twitter, or (surprise!) as`
		`+ https://discussion.fedoraproject.org/u/mattdm/[mattdm]`
		`+ on`
		`+ https://discussion.fedoraproject.org/[Fedora Discussion].`

		`== Previous Fedora Project Leaders`

council/modules/ROOT/pages/index.adoc

file modified

+4 -4

		`@@ -221,7 +221,7 @@`
		`~~~~~~~~`

		`The Fedora Council is not driven by meetings or by tickets, but does`
		`- hold https://fedoraproject.org/wiki/Council_Meetings[regular public IRC meetings] to`
		`+ hold https://fedoraproject.org/wiki/Council_Meetings[regular public meetings] to`
		`discuss current issues, to clear through anything outstanding which can`
		`be quickly resolved, and to ensure that nothing important is left in`
		`limbo. All members are be expected to regularly communicate what's going`
		`@@ -236,10 +236,10 @@`
		`~~~~~~~~~~~~`

		`The general policy of the Fedora Council is to default to open. Meetings`
		`- are held in public IRC channels, and open to all Fedora users and`
		`+ are held in public Matrix channels, and are open to all Fedora users and`
		`contributors. Discussion is held in on a`
		`- https://lists.fedoraproject.org/mailman/listinfo/council-discuss[public`
		`- mailing list] open to all subscribers, and formal decisions will be`
		`+ https://discussion.fedoraproject.org/tag/council[public`
		`+ forum] open to all, and formal decisions will be`
		`recorded in a public ticket tracking system.`

		`Occasionally, when personal, private, or sensitive issues need to be`

mattdm commented 2 years ago

This is mostly a significant rewrite of contact.adoc, plus some other changes in other pages.

rebased onto ee96a2d

2 years ago

bcotton commented on line 28 of council/modules/ROOT/pages/index.adoc 2 years ago

I don't think this qualifies for inclusion here. I'd argue it's not a change in meaning, just a change in implementation of existing meaning. "Did the Council have to vote on this change?" is a reasonable bar, IMO

bcotton commented on line 56 of council/modules/ROOT/pages/contact.adoc 2 years ago

We should take this opportunity to tighten the language a bit. "If you have a specific proposal for the Council..." is too tight, but it'd be helpful to make it more clear that tickets are for actions, not discussions. I'd rather have people start "this should be a ticket" threads on Discussion than open "this should be a Discussion thread" tickets, if that makes sense.

1 new commit added