Re: [jakarta.ee-community] Guide to Contributing to Jakarta EE 10

[Ivar Grimstad <ivar.grimstad@xxxxxxxxxxxxxxxxxxxxxx>]

On Mon, Jul 13, 2020 at 2:11 AM reza_rahman <reza_rahman@xxxxxxxxx> wrote:

An interesting consideration came up in the context of the guide that I believe I have clarity on, but it feels l like I should confirm.

For Jakarta EE and indeed for the Eclipse Foundation generally, project mailing lists appear to be the canonical communication mechanism. This means that we should all be at least making a good faith effort to centralize substantive discussions and decision making in the mailing lists.

This certainly seems sensible to me as a way of maximizing transparency and inclusion, especially for folks that may have limited time and engagement at any given moment. Now, of course it is understandable that some discussion organically happens in places like GitHub issues, Slack channels, etc as long as we remain consious of trying not to replace a more inclusive communication mechanism instead of sensibly supplementing it.

Could the right folks kindly clarify (e.g. Wayne, Mike, Tanja, Ivar)? Also, what do folks here think - especially folks that are not heavily engaged today but could be in the future? What works best for you in terms of inclusion and transparency in the likely limited time you have?

I think it is up to each project to choose how they communicate as long as it is inclusive and transparent. 

My 2 cents on suggested guidelines:

- Project mailing lists should be the primary channel of communication.

- Decisions, voting and such should be done on the mailing lists

- Discussions on the mailing list could typically result in GitHub issues

- Hammering down the details of a particular issue is probably best to do by commenting on the issue directly

- Channels like Slack, Gitter, etc. are fine to use for sync ad-hoc discussions and clarifications. 

- It could be a good practice to post the results of these discussions on the mailing list if relevant for the broader community

Ivar

 

It would be good to have clarity so we can bake in clarity and simplicity into the guide. I think that helps everyone in the end.

Reza Rahman

Jakarta EE Ambassador, Author, Blogger, Speaker

Please note views expressed here are my own as an individual community member and do not reflect the views of my employer.

Sent via the Samsung Galaxy S7, an AT&T 4G LTE smartphone

-------- Original message --------

From: Reza Rahman <reza_rahman@xxxxxxxxx>

Date: 7/11/20 11:53 PM (GMT-05:00)

To: Jakarta EE community discussions <jakarta.ee-community@xxxxxxxxxxx>, Jakarta EE Ambassadors <jakartaee-ambassadors@xxxxxxxxxxxxxxxx>

Subject: Re: Guide to Contributing to Jakarta EE 10

The first draft is now complete, could folks kindly take a look:
https://docs.google.com/document/d/1uZFBoIujXCc-gQhCzh_ZdlKEsrsV0yVVIHzBTI3usF8/edit?usp=sharing?

Obviously there are a lot of possible things across the platform and
ecosystem, but I do believe it is best to focus on a simple, brief,
end-user focused and mostly self-contained resource (to be ultimately
part of the Jakarta EE Ambassadors website).

If possible, I would like to finalize this by next weekend.

Reza Rahman
Jakarta EE Ambassador, Author, Blogger, Speaker

Please note views expressed here are my own as an individual community
member and do not reflect the views of my employer.

On 7/5/2020 11:16 PM, Reza Rahman wrote:
> Just a quick heads up that as promised I started drafting the guide
> this weekend:
> https://docs.google.com/document/d/1uZFBoIujXCc-gQhCzh_ZdlKEsrsV0yVVIHzBTI3usF8/edit?usp=sharing.
> I was planning to get a draft done by today but holiday family
> obligations got in the way.
>
> I hope to get it ready for review by next weekend.
>
> Reza Rahman
> Jakarta EE Ambassador, Author, Blogger, Speaker
>
> Please note views expressed here are my own as an individual community
> member and do not reflect the views of my employer.
>

_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

--

Ivar Grimstad

Jakarta EE Developer Advocate | Eclipse Foundation, Inc.

Community. Code. Collaboration. 

Join us at our virtual event: EclipseCon 2020 - October 20-22