Implementing the Open Regulatory Compliance Working Group Website

Hi, we would like to Implement a new website for the Open Regulatory Compliance Working Group, please. Please note that a new repo needs to be created for the orcwg.org website.

Here are the links to the mockups:

• https://xd.adobe.com/view/8c17c13f-e777-4a70-a620-856b31d12a51-d944/
• https://xd.adobe.com/view/4d7c273c-6846-4565-962a-b110341c421e-182f/
• https://xd.adobe.com/view/917acda4-7c1c-43fe-8ba6-6b33d92e7452-c429/

Here is the google doc and the embed code

The visual assets are attached here:

Banner__images.zip

Membership form embed code:

<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/embed/v2.js"></script>
<script>
  hbspt.forms.create({
    region: "na1",
    portalId: "5413615",
    formId: "ab5e3824-d298-4a56-ad67-592e31e29562"
  });
</script>

assigned to @oliviergoulet

added team:webdev label

@scorbett have you created an issue for the domain name yet?

I will create the repo/project on Gitlab once @scorbett has confirmed the domain since we use the URL as the name of the project

Will it be orcwg.org as you stated in the description @sgiacomoni2as or is this still in discussion?

Please wait for @scorbett to confirm. I believe a domain was already purchased by Paul but I'm not 100%.

@pwhited3w is buying domains now? What does he not do?

LOL - that sounds scary AND wrong. Two domains were purchased by WebDev a few weeks ago.

If you find me ever starting to mess with domain names, please take my keyboard away.

LOL - that sounds scary AND wrong. Two domains were purchased by WebDev a few weeks ago.

If you find me ever starting to mess with domain names, please take my keyboard away.

@pwhited3w LOL, That was funny!

In all seriousness, I suspect you meant infra team! I will ask Christopher Hills.

@chills2023 Are you familiar with the domains that were purchased for the Open Regulatory Compliance Working Group Website?

@cguindon it doesn't remind me anything, maybe someone else from the infra team. I'll ask the team

@cguindon we bought those 2 domains recently : orcwg.org and orcwg.io

Thanks @chills2023 - @scorbett let me know which we should use as the default.

@cguindon I've put a request on the internal ORC slack channel to get a recommendation. Is EOD Monday OK to us to get you an answer?

added team:infra label

added team:marketing label

added webdev:front-end label

assigned to @oliviergoulet

Thanks @scorbett and @pwhited3w - Monday is fine! Have a great weekend!

orcwg.org will be the default. Thanks for your patience!

Thanks @scorbett - Do we need to work on this website privately or can we work on a public project?

Hi All - Please take notice that I moved this issue to it's new location: https://gitlab.eclipse.org/eclipsefdn/it/websites/orcwg.org

The initial commit for this site was done today: 6eeff525

Also created the Jenkins projects for CI: https://foundation.eclipse.org/ci/webdev/job/public/job/orcwg.org/

@oliviergoulet You should have everything you need now to get started on this task! Let us know if you have any questions!

@scorbett has confirmed on the old issue that we can make this project public.

It is now public!

mentioned in merge request !1 (merged)

@mkokabi @sgiacomoni2as Will the logo in the footer always be Eclipse Foundation, or will it use a working group's logo if they have one?

@sgiacomoni2as Is not available this week! I will reply on her behalf:

For the footer, you can assume it's always the foundation logo for now. We can always change that later if we have a different use case.

This is based on our WG website slides: https://docs.google.com/presentation/d/1p3hJWdrT0U8IpHdOzDgdUjsS0gVxdl-YViE6Ht4XVAA/edit#slide=id.g2ca45d65fec_0_18

They have a placeholder for the logo in the header but in the footer, it's the EF logo without a placeholder.

Hi @oliviergoulet sorry for the delay, I am also sick today and working on and off. As @cguindon mentioned, we want this always to be the Eclipse Foundation logo. Thank you both!

changed due date to July 26, 2024

I'm noticing that many of the members for ORC have no logos uploaded:

Page 1:

Page 2:

@zfazli Would it be possible to have more logos uploaded before we go live with the website? Many are also missing their website urls.

I can improve how the logo-less members display in the meantime.

I will reach out to request logos

Here is an early preview:

• https://preview-1--orcwg-org.eclipsecontent.org/
• https://preview-1--orcwg-org.eclipsecontent.org/about/
• https://preview-1--orcwg-org.eclipsecontent.org/membership/

The event timeline is still a work in progress. But aside from that, I would appreciate some feedback!

@mkokabi @sgiacomoni2as @scorbett

+ @tobielangel

Thanks for shipping this first preview!

A few questions:

1. Are community news and events WG-specific? If so, how are those updated / sourced?
2. On the landing page, the secondary CTA links to a blog post. Is the plan to keep this?
3. There's a foundation-wide banner right above the footer with its own CTA. Is the plan to replace this with a WG-specific CTA? This feels a little confusing for now.
4. The membership FAQ is currently a PDF. Is there a plan to turn that into regular HTML content?
5. The content of the about page needs an update. What's the best way to go about this? Are there good examples of effective WG about page that we could use for inspiration? Are there good visuals that could help convey what the WG is about?

Hi @oliviergoulet thanks looks good to me! just some small tweaks ( fixing the dot to be centralized and increasing the top spacing on the second one please.

@tobielangel

1. Are community news and events WG-specific? If so, how are those updated / sourced?

I forgot to mention I am using the news feed for eclipse.org for the preview. This was to show how news items would appear. The ORC news feed is currently empty and would show as:

2. On the landing page, the secondary CTA links to a blog post. Is the plan to keep this?

It's linked to the working group charter, but I believe it should be linked to a pitch deck. @jharrisj1m, can you provide the URL for the second CTA?

3. There's a foundation-wide banner right above the footer with its own CTA. Is the plan to replace this with a WG-specific CTA? This feels a little confusing for now.

Yes, that is the plan. Much like the news situation, it was targeting eclipse.org. I just now made the change for ORC.

It should now show a generic message about discovering Eclipse Foundation events. Once a featured story has been published for ORC, it should appear in the banner.

4. The membership FAQ is currently a PDF. Is there a plan to turn that into regular HTML content?

I can do this now! It's mostly text content, so it should be quick.

5. The content of the about page needs an update...

For the text itself, the best option would be to suggest edits on the Google Doc.

I don't think we'll have time to make any major changes to the page's appearance if we're targeting going live on Friday. You could make a new issue here or in the marketing repo requesting an update to the design: https://gitlab.eclipse.org/eclipsefdn/marketing/-/issues

Please let me know if you have any other questions!

@mkokabi I added more margins under the breadcrumb. As for the timeline, this part is still in progress!

Thanks a lot for all of the clarifications! I'm still working my way around all of this. Where do I find the relevant feeds you'll be feeding of from?

RE: linking to a pitch deck in the "learn more" CTA, I don't know if that asset exists yet, so in the mean time I think it is fair to leave the link to the charter.

Also, we will be adding the resources listed here to the "community news" section through newsroom once the website is equipped to do that

Also, the questions on https://preview-1--orcwg-org.eclipsecontent.org/about/ are a bit out of date, so what are our thoughts on adding this content there instead: https://outreach.eclipse.foundation/hubfs/Open%20Regulatory%20Compliance%20Working%20Group%20FAQ.pdf

What do you think @tobielangel?

If we're leaving the charter, then the CTA button can't be "Learn more". @mplagge is there a set of slides we could use as a generic pitch deck?

marked this issue as blocked by newsroom.eclipse.org#145 (closed)

This is a great start, and I like the look of it. Here are my suggested edits.

1. On the home page a) "Join the WG" takes you to the join as a member page; while it works, this is a bit jarring. Not necessary for launch if we don't have it, but ideally there would be a page off the membership tab explaining how to get involved, ask whether you're already a member of Eclipse, explain membership, etc. b) "Learn More" takes you to the charter; same as above - would be better to be taken to a resources page or something similar rather than the charter. c) Just a nit, but given not all the logos fit, making these random rather than alphabetical would be more appropriate.

2. About page a) More about ORC needs a different action, or simply relabel to "Working Group Charter" (which wouldn't be a bad thing).

3. Membership page This needs a bit of text as preamble stating this is an industry initiative that brings together .... (@croundy do we have some basic text to use).

And while we would normally state "Our Members", in this particular working group case, I think "Working Group Members" is more appropriate in this case.

Payara is not a Strategic member.

4. Join the Mailing List This seems the wrong header. "Participate" or "How to Participate" would be more appropriate, and Join the Mailing List is just one of the actions. This section should list that all are welcome to follow, to join the mailing list, and to contribute to the discussion.

5. While we may not have it immediately, this WG begs for a Resources tab. @tobielangel do we have anything we can include as yet?

This is the Key Working Group Resources that Tobie and I have currently arranged - see this doc cc @tobielangel

@pwhited3w Thanks for the feedback! I have made some changes:

2. About page a) More about ORC needs a different action, or simply relabel to "Working Group Charter" (which wouldn't be a bad thing).

I have relabelled the button as "Working Group Charter" while we wait for a pitch deck

And while we would normally state "Our Members", in this particular working group case, I think "Working Group Members" is more appropriate in this case.

I have made this change on the membership page.

Payara is not a Strategic member.

This was a bug with the member list that has now been fixed.

Join the Mailing List This seems the wrong header.

I renamed the link to "Participate"

While we may not have it immediately, this WG begs for a Resources tab.

I'll create this page separately so that if it is still incomplete, it won't block the entire website from going live.

Thanks for making the updates. A few further comments.

Agreed the heading off the home page needs to be Participate. But this can't go directly to a mailing list. It needs to have a separate page that describes how folks can participate, and one of the links or CTAs on that page includes joining the mailing list. We can't go live without fixing this. @croundy hopefully this is straightforward to draft.

@pwhited3w, is the google doc @scorbett shared above what you had in mind in terms of content? Alternatively, would leveraging content from either of these GitLab READMEs be a good start?

• https://gitlab.eclipse.org/eclipse-wg/open-regulatory-compliance-wg/gitlab-profile/-/blob/main/README.md#getting-involved
• https://gitlab.eclipse.org/eclipse-wg/open-regulatory-compliance-wg/cra-topics#cra-resources

Yes, it's exactly what I had in mind. Thanks for generating

@croundy @pwhited3w I could draft some content for the "Participate/Get Involved" page based on the README Tobie provided? This would include a short preamble about the goals of the working group and why members should join, plus links to the Mailing list, Matrix chat, community calendar and eclipse.org/membership/join-us.

Thanks @jharrisj1m. @tobielangel and I are using the Google doc as the primary source of truth for the initial website. This content on the document is already a bit different than the site preview pages. I would suggest that we iterate on the Google doc for the time being and then provide a "final" version to @oliviergoulet for implementation. Any objections? https://docs.google.com/document/d/17I_AcItz-5V-DxJJmJOpk1bLgaLIcDdaxIFdFmQgzdM/edit#heading=h.w6ahxupthav8

@scorbett @pwhited3w FYI

@jharrisj1m @tobielangel @scorbett @pwhited3w Would appreciate if each of you can take a few minutes and go through the Google doc. A few things to highlight:

1. Introductory text has been added to each page.

2. Tobie has made some significant text changes to the "About" page. Still a little cleanup to do.

3. We've added content for the "Participate" page so it doesn't go directly to the Mailing list link

4. We've suggested the top navigation be: About, Members, Participate, Resources (perhaps implemented later or just a few links) and FAQs

5. We've suggested a number of CTA changes.

   It's not perfect, but I think with your review it will be close enough to send to @oliviergoulet and finalize the first implementation. Thanks all! https://docs.google.com/document/d/17I_AcItz-5V-DxJJmJOpk1bLgaLIcDdaxIFdFmQgzdM/edit

@mkokabi Can we have some images for the events and news tile?

Sure @oliviergoulet will add here shortly.

@oliviergoulet Here you are:

Thanks @mkokabi !

Do you have higher-quality ones? Preferably 450px wide images as a minimum size.

@mkokabi do we have a more appropriate image available for the news tile?

@mkokabi It's not clear how these images relate to "news." Can we please find something that better reflects News? For "events," let's try to keep it a bit more generic. The classroom one or similar is probably fine so long as it's got good enough resolution.

Here you are!

@tobielangel There is now a FAQ page as opposed to before when we only had the PDF:

https://preview-1--orcwg-org.eclipsecontent.org/about/participation-and-membership-faq/

@croundy @tobielangel - I recommend merging @oliviergoulet's work soon once we determine the site is in a good enough state to publish. This way, we can get the site into production and allow Google and other services to index the content before we start promoting it.

I’m fine with everyone continuing to work with Olivier on improvements after the initial deployment, but we shouldn't delay the site launch too long because we are aiming for perfection. DNS propagation could take up to 48 hours for some users. It would be best to get that sorted out a few days before the team start promoting the site. This is why I think getting this done today is a good idea.

Could we aim to deploy the first version today? I prefer not to launch a new site on a Friday.

Thanks

Thanks @cguindon to you and @oliviergoulet for all the help and good work with this! Rather than put too much stress on your team to publish this week, let's give ourselves a little more time to make sure we get it right. There are a few important content additions/changes that should be part of the initial launch. Let's give ourselves at least through today to make sure this Google doc accurately represents the content we want for the initial roll out and then give your team another week or so to implement. Does that work? https://docs.google.com/document/d/17I_AcItz-5V-DxJJmJOpk1bLgaLIcDdaxIFdFmQgzdM/edit

That works for me! Thanks @croundy for the update! I've pushed the deadline to August 1st!

changed due date to August 01, 2024

added statewip label

@cguindon @oliviergoulet

From a content and flow perspective, I think we are now in a pretty good state with this document: https://docs.google.com/document/d/17I_AcItz-5V-DxJJmJOpk1bLgaLIcDdaxIFdFmQgzdM/edit#heading=h.jaglnl7igqpq

Let's move this forward. Note a couple of things:

1. We will have a logo and some branding elements to be integrated in the not too distant future.
2. There will be a link to a separate "Resources hub" needed at some point. @tobielangel will provide more guidance around this as it comes together.
3. We should coordinate on how to best add news and updates (i.e. a newsroom like we do with Eclipse.org?) @jharrisj1m to be marketing point on this.

Please let me know of any questions or concerns. Many thanks!

@mkokabi @scorbett @pwhited3w FYI

I made a few small suggestions in specific language, but this is g2g IMO. +1

... and thanks for the updates. It's appreciated

thanks @pwhited3w. your suggestions have been accepted/incorporated into the Google doc.

Hi @mkokabi, I need three images for the "Participate" page. I left a comment in the Google Doc with more details.

I made an attempt to have the participate page look similar to Jakarta EE's "Get Involved" page:

https://preview-1--orcwg-org.eclipsecontent.org/participate/

@mkokabi @croundy @tobielangel Let me know if this is a layout we want to keep.

I forgot to add the links for "Join the Conversation". I will add buttons for those, but I want to get early feedback on the page layout as a whole.

The images are also temporary.

@oliviergoulet I like the look. It feels clean and welcoming. Good job!

@oliviergoulet Well done! +1

Hi everyone,

Please take a look at the preview. I have incorporated the text content from the new Google Doc:

• https://preview-1--orcwg-org.eclipsecontent.org/
• https://preview-1--orcwg-org.eclipsecontent.org/participate/
• https://preview-1--orcwg-org.eclipsecontent.org/about/
• https://preview-1--orcwg-org.eclipsecontent.org/membership/
• https://preview-1--orcwg-org.eclipsecontent.org/about/participation-and-membership-faq/

@croundy @pwhited3w @tobielangel

Thanks @oliviergoulet. Overall, it looks great and on the most part I think we could go live as is. A few minor nits:

Home page:

• Community News Image could look more like a "News" image. @mkokabi provided an option, though we might still find something more appropriate
• Seems we're still missing the logos/links to members

Participation Page:

• Under "Become a Member of the Working Group" the links are difficult to see. Let's make them more visible like the other links on the page

Membership Page:

• Change the CTA from "Contact us" to "Contact Us About Membership"
• Again, member logos/links are still missing
• Do we need to eliminate the "Strategic Members" section for now since there aren't any?

FAQ Page:

It looks like we've consolidated multiple questions and answers into 1. Let's split this into 4 questions, each with separate answers:

WHO CAN PROVIDE FEEDBACK ON THE WORKING GROUP CHARTER? HOW CAN I PROVIDE FEEDBACK? WHAT IS THE LAST OPPORTUNITY THE COMMUNITY WILL HAVE TO PROVIDE FEEDBACK? HOW IS THE FEEDBACK HANDLED?

Feedback from all parties is appreciated as we formalise the Charter. Feedback may be sent to the public mailing list.

Feedback is welcome up until the time the Steering Committee approves the charter, typically in the first or second meeting of the Steering Committee (so likely later in June or early July). All feedback will be collected and made available to the Steering Committee for their consideration.

It’s worth noting that significant feedback has already been given on the mailing list, which is great to see.

As with any initiative with such a diversity of stakeholders and interested parties, we want to use this as a chance to highlight that the Eclipse Foundation governance does not require unanimity. Rather, as will be the case with all decisions to be taken by the working group committees, the Steering Committee will approve the Draft Charter in its first or second meeting. In the case of approval of a charter, a supermajority vote of ⅔ of members is required. It’s also worth pointing out that our governance model permits the Steering Committee to decide at a future date to modify or update the charter if it feels it is appropriate using the same process.

Finally, how close are we to having a Resource Hub to link to @tobielangel? Are we ready to add that to the top nav of this website? And, should it be referenced elsewhere as well?

1. Could we change the capitalization of this section in the jumbotron to match this:

Key stakeholders from industry and open source communities are collaborating to support compliance with government regulations, ensuring the continued use and advancement of open source through the software supply chain.

2. I added some articles to the "community news" section of the website, but only the ones marked as the announcements are only showing up on the homepage. Would we be able to show both "community updates" and "announcements" in this section? Also, this page is empty, but maybe that will change when it is live: https://preview-1--orcwg-org.eclipsecontent.org/news/

+1 to Clark's suggestions, but agreed that overall, this is ready to go.

Thanks everyone!

Hi, everyone! The site is now up.

Please do not promote the website until Monday. It can take up to 48 hours for the DNS records to propagate across the internet. In other words, the website may be inaccessible to some users until then.

https://orcwg.org/

I plan on sharing additional previews next week to address the feedback given yesterday.

Thanks @oliviergoulet. I also noticed that the FAQ page isn't setup as a top nav option, which means there's only 1 link to that page (on the About page). Unless anyone else has an objection, It seems appropriate to make sure that page is easily found by having it on the top nav (at least for now).

Thanks, and please let us know when the other feedback has been implemented.

mentioned in merge request !2 (merged)

Hi @croundy and @jharrisj1m

Here is a new preview URL containing the changes based on your feedback: https://preview-2--orcwg-org.eclipsecontent.org/

Note that this is a new preview URL! The preview previously shared will appear outdated.

Feedback from @croundy

I have implemented your feedback, except for the logos and FAQ.

I will need the text content for the answers to the four questions.

As for the member logos, @zfazli should be able to help us with this via the membership portal. See #1 (comment 2548370).

Feedback from @jharrisj1m

Would we be able to show both "community updates" and "announcements" in this section?

The community updates and announcements are both being shown now. We made this change shortly before going live.

Could we change the capitalization of this section in the jumbotron to match this

This is still planned. The theme currently enforces title casing for the jumbotron subtitle and headline text. We will push an update separately to fix this.

Thanks, looks great!

Thanks @oliviergoulet. Overall it looks great!. Push it live when ready. For the FAQs, let's change the previously referenced text (currently 4 different questions) and make them 1 question and 1 answer as follows:

HOW AND UNTIL WHEN CAN FEEDBACK ON THE WORKING GROUP CHARTER BE PROVIDED?

Feedback from all parties is appreciated as we formalise the Charter. Feedback may be sent to the public mailing list.

Feedback is welcome up until the time the Steering Committee approves the charter, typically in the first or second meeting of the Steering Committee. All feedback will be collected and made available to the Steering Committee for their consideration.

As with any initiative with such a diversity of stakeholders and interested parties, we want to use this as a chance to highlight that the Eclipse Foundation governance does not require unanimity. Rather, as will be the case with all decisions to be taken by the working group committees, the Steering Committee will approve the Draft Charter in its first or second meeting. In the case of approval of a charter, a supermajority vote of ⅔ of members is required. It’s also worth pointing out that our governance model permits the Steering Committee to decide at a future date to modify or update the charter if it feels it is appropriate using the same process.

Thanks @croundy! The changes you approved yesterday are now live.

Here is a preview for the FAQ change: https://preview-3--orcwg-org.eclipsecontent.org/about/participation-and-membership-faq/#how-and-until-when-can-feedback-on-the-working-group-charter-be-provided

@oliviergoulet LGTM. Thanks!

mentioned in merge request !3 (merged)

added statereview label and removed statewip label

added statedone label and removed statereview label

closed

mentioned in issue #4 (closed)

@oliviergoulet Just noticed that on the Membership page, the "Strategic Members" section is still there. Can you please temporarily remove it until we get one or more strategics? Thanks

Will do! I created the following issue to track this: #5 (closed)

added wg:Open Regulatory Compliance label