Governance section #1504

anatoliykmetyuk · 2023-05-22T12:25:20Z

URL will be https://scala-lang.org/community/#governance

SethTisue

how about something about the Scala Center advisory board (including community rep(s))?

_data/governance.yml

Co-authored-by: Seth Tisue <[email protected]>

bishabosha · 2023-05-25T11:31:08Z

Here is what It looks like when I move the "update frequency" box into a separate paragraph.

julienrf · 2023-05-25T13:38:52Z

_data/governance.yml

+introText: This section is updated every 6 months by the Scala Center.
+cards:
+  - title: "Scala Improvement Process"
+    description: "The SIP is the primary mechanism for evolving the Scala language."


I think it would be good to expand a little bit the description. What about the following?

This process aims to evolve Scala openly and collaboratively. Anyone from the community is welcome to submit a Scala Improvement Proposal (SIP), which is then reviewed and discussed by a Committee. Every month, the Committee votes on the proposals to accept in the language.

ok, but this will take many lines of text, is it ok to go in the expanded section?

Personally, I find the current description too short: it does not really provides anything in addition to the title. Is it a problem to make descriptions a bit longer?

in the context of being the top of the community page, it adds a lot of vertical space, also the other boxes don't have a similar amount of text, so leading to empty space

_data/governance.yml

julienrf · 2023-05-25T13:43:29Z

_data/governance.yml

+    links:
+      - name: Core Maintainers
+        url: https://github.com/lampepfl/dotty/blob/main/MAINTENANCE.md#compiler
+      - name: Maintenance Procedures
+        url: https://github.com/lampepfl/dotty/blob/main/MAINTENANCE.md


Here too, both links point to the same page. Also, that page dives deep into the issue supervisor role without giving an overview of all the organizations (I see at least LAMP and VirtusLab) involved in the maintenance of the compiler and their respective role.

Last, the description above mentions the standard library and the documentation, which are not covered by the links.

This information should probably be added to the MAINTENANCE.md as a separate PR.

julienrf · 2023-05-25T13:44:32Z

_data/governance.yml

+        url: https://docs.scala-lang.org/sips/process-specification.html#the-sip-committee
+      - name: SIP Process Specification
+        url: https://docs.scala-lang.org/sips/process-specification.html
+  - title: "Scala 3 Maintenance"


I think we should cover both Scala 2 and Scala 3.

@lrytz can you help us out here? In terms of the maintenance of Scala 2, what resources can we reference for the current process and people involved?

https://github.com/scala/scala#how-to-contribute

https://github.com/scala/scala#get-in-touch

cc @SethTisue

Yeah, those are pretty up to date. If you feel anything is missing, let me know.

julienrf · 2023-05-25T13:46:15Z

_data/governance.yml

+    description: "Managing build tools, linters, IDEs, and other tools."
+    expandText: "Process & People"
+    links:
+      - text: "Process and People are TBD, please stay tuned! However you can read below about the Scala Tooling Summit:"


I think this section should be filled before we merge the PR.

The current status on this is that we've only conducted one Tooling Summit during which no process was adopted. Changing this might be the goal for the next Summit in September.

Even if there is no “process”, I would expect the Governance section to give more understanding to the readers about which organizations do exist and actively work on the tooling ecosystem. I think we should mention at least VirtusLab with Scala CLI and Metals, and Jetbrains with IntelliJ.

julienrf · 2023-05-25T13:48:00Z

_data/governance.yml

+      - name: "Scala Tooling Summit of March 2023"
+        url: https://www.scala-lang.org/blog/2023/04/11/march-2023-scala-tooling-summit.html
+  - title: "Moderation"
+    description: "Learn how the Scala community is moderated."


I don’t have a concrete suggestion to make, but I think the description should summarize what we see in the links (the fact that there is a moderation team, a code of conduct, etc.).

_includes/masthead-community.html

julienrf · 2023-05-25T13:50:46Z

I think there should be a card about the role of the Scala Center: its mission, scope, and funding.

julienrf

Thank you, I think it is a good thing to put together those important links here.

I still think we should provide more explanations about the role of every involved organization, but maybe that could be added later if other people agree that this is important.

_data/governance.yml

julienrf · 2023-05-31T13:17:05Z

_data/governance.yml

+  - title: "Scala 2 Maintenance"
+    description: "Who maintains the Scala 2 compiler?"
+    expandText: "Process & People"
+    links:
+      - name: "Contribution Process"
+        url: "https://github.com/scala/scala#how-to-contribute"
+      - name: "Core Maintainers"
+        url: "https://github.com/scala/scala#get-in-touch"


Thank you for adding this card. I am a bit confused because its content is pretty different from the Scala 3 Maintenance card. Would it be possible to make them more similar?

This would require making the actual processes similar :) which is not the case.

In the case of Scala 3, we have an Issue Supervisor role, which is specced as an actual procedure that we follow weekly to monitor the new issues, identify critical ones, and schedule them in a milestone for fixing. For Scala 2, the link I specified doesn't describe a maintenance procedure but rather how to push your own contribution.

Since the nature of the two documents is so different, I don't think we can't label the Scala 2 link as Maintenance Procedures in the same way the Scala 3 one is called that way.

julienrf · 2023-05-31T13:18:31Z

_data/governance.yml

@@ -0,0 +1,61 @@
+introText: This section is updated every 6 months by the Scala Center.


I think this comment is not necessary. We should anyway update the content as frequently as necessary (sometimes more than once every six months, but most of the time I guess this will not change within a year).

Co-authored-by: Julien Richard-Foy <[email protected]>

SethTisue · 2023-06-01T19:43:53Z

related: scala/scala.epfl.ch#259 ("Make a page dedicated to the community rep")

darjutak · 2023-06-02T09:21:08Z

Thank you all for creating and updating this page! I'll go ahead and merge it now, but the work is not yet fully done, which is why we added "development of this page progress”.

Governance block draft

507bab4

anatoliykmetyuk requested a review from bishabosha May 22, 2023 12:25

anatoliykmetyuk assigned bishabosha May 22, 2023

bishabosha force-pushed the governance-block branch 4 times, most recently from 12655b1 to d3479ee Compare May 24, 2023 14:58

Improve styling, adjust text.

85eeed6

bishabosha force-pushed the governance-block branch from d3479ee to 85eeed6 Compare May 24, 2023 15:09

bishabosha assigned darjutak and julienrf and unassigned bishabosha May 24, 2023

bishabosha requested review from darjutak and julienrf and removed request for bishabosha May 24, 2023 15:10

bishabosha marked this pull request as ready for review May 24, 2023 15:10

bishabosha changed the title ~~Governance block draft~~ Governance section May 24, 2023

SethTisue reviewed May 24, 2023

View reviewed changes

_data/governance.yml Outdated Show resolved Hide resolved

adpi2 reviewed May 25, 2023

View reviewed changes

_data/governance.yml Outdated Show resolved Hide resolved

anatoliykmetyuk and others added 2 commits May 25, 2023 11:39

Update _data/governance.yml

188aa5c

Co-authored-by: Seth Tisue <[email protected]>

move update frequency to into paragraph

d880f4c

julienrf reviewed May 25, 2023

View reviewed changes

bishabosha marked this pull request as draft May 25, 2023 14:01

Add more info about SIP, the moderation, the Scala Center and Scala 2.

ae403d9

anatoliykmetyuk requested a review from julienrf May 31, 2023 12:07

julienrf reviewed May 31, 2023

View reviewed changes

anatoliykmetyuk and others added 2 commits May 31, 2023 16:09

Update _data/governance.yml

2f282c0

Co-authored-by: Julien Richard-Foy <[email protected]>

Remove intro block

540d41e

anatoliykmetyuk marked this pull request as ready for review June 2, 2023 08:23

Add WIP disclaimer to the governance page

e983985

darjutak merged commit ac67bfe into main Jun 2, 2023

bishabosha deleted the governance-block branch November 23, 2023 12:49

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Governance section #1504

Governance section #1504

anatoliykmetyuk commented May 22, 2023 •

edited by bishabosha

Loading

SethTisue left a comment

bishabosha commented May 25, 2023 •

edited

Loading

julienrf May 25, 2023

bishabosha May 25, 2023

julienrf May 25, 2023

bishabosha May 25, 2023 •

edited

Loading

julienrf May 25, 2023

anatoliykmetyuk May 30, 2023

julienrf May 25, 2023

anatoliykmetyuk May 30, 2023

lrytz May 31, 2023

SethTisue Jun 1, 2023

julienrf May 25, 2023

anatoliykmetyuk May 30, 2023

julienrf May 30, 2023

julienrf May 25, 2023

julienrf commented May 25, 2023

julienrf left a comment

julienrf May 31, 2023

anatoliykmetyuk May 31, 2023

julienrf May 31, 2023

SethTisue commented Jun 1, 2023 •

edited

Loading

darjutak commented Jun 2, 2023

		@@ -0,0 +1,61 @@
		introText: This section is updated every 6 months by the Scala Center.

Governance section #1504

Governance section #1504

Conversation

anatoliykmetyuk commented May 22, 2023 • edited by bishabosha Loading

SethTisue left a comment

Choose a reason for hiding this comment

bishabosha commented May 25, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

bishabosha May 25, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

julienrf commented May 25, 2023

julienrf left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

SethTisue commented Jun 1, 2023 • edited Loading

darjutak commented Jun 2, 2023

anatoliykmetyuk commented May 22, 2023 •

edited by bishabosha

Loading

bishabosha commented May 25, 2023 •

edited

Loading

bishabosha May 25, 2023 •

edited

Loading

SethTisue commented Jun 1, 2023 •

edited

Loading