Skip to content

Conversation

@ericgregory
Copy link
Contributor

This PR starts the work of revamping the Projects page to be a) comprehensive and b) a more useful tool for project discovery.

The update adds all of the projects listed in the governance/projects document, but the most important piece is that it adds projects via a project data file (_data/projects.yml), so we can easily change how we actually present the projects in the future. (For example, a next step might be to organize projects by category on the Projects page, filtering by labels in the data file.) It also suggests a path for automating updates from the centralized governance repo in the future (i.e. a yaml file could be maintained there and then piped in to this repo via workflow).

Signed-off-by: Eric Gregory <egregory04@gmail.com>
Signed-off-by: Eric Gregory <egregory04@gmail.com>
Signed-off-by: Eric Gregory <egregory04@gmail.com>
@disquisitioner
Copy link
Collaborator

Great idea, @ericgregory -- and nice to have this be managed, configured, and generated as part of building the site. As it happens there are other ideas afloat regarding how we list and describe our projects. I'll ping you separately so we can strategize on that work and fold in the examples you've mentioned here. Thank you!

Signed-off-by: Eric Gregory <egregory04@gmail.com>
@ericgregory
Copy link
Contributor Author

Hi @disquisitioner -- I've made several updates per our last conversation! The latest commit...

  • Adds project status field with values "core" and "hosted"
  • Presents Core and Hosted projects separately on the projects page
  • Introduces the concept of Core and Hosted projects and links to the requirements for each
  • Moves "project security" section to the top of the page for greater visibility
  • Removes specific listing of projects in FAQ on homepage

@disquisitioner
Copy link
Collaborator

Looks good @ericgregory -- thanks! This gets us the revised Projects page structure we'd discussed, preserving the existing aspects and making it possible to mention all our projects (even though that makes the page longer overall). I like that each project mentioned can link to its website, repo, and docs. Perhaps over time we can round that out for more projects and add other info there, e.g. Zulip channel, relevant SIG, etc. Thanks for adjusting the FAQ on the home page too.

While we're not planning to do it now, I presume it'd be reasonably straightforward later on to add a way to tag projects and reflect their type, language, etc. I like that dynamically generating the page from data makes that possible.

For now we'll maintain the _data/projects.yml file manually but look for a time in the future to generate that via an action based on a master list in the governance repo, correct?

In terms of timing for publishing this PR, at the moment we haven't formally announced any Core Projects though are coordinating with folks to do that and hopefully very soon. Let me check on that and get back to you.

@abrown
Copy link
Member

abrown commented Apr 15, 2025

If this was waiting for bytecodealliance/governance#124, that is merged now.

@disquisitioner
Copy link
Collaborator

Thanks, @abrown! I don't see any reason why you can't proceed and merge this PR @ericgregory, given the last bits of the Core Project approval process have now been completed. Thanks for putting this together!

@ericgregory
Copy link
Contributor Author

@disquisitioner Thanks! I don't have merge powers -- would you be able to merge this?

@disquisitioner disquisitioner merged commit 9fe7f41 into bytecodealliance:gh-pages Apr 23, 2025
@disquisitioner
Copy link
Collaborator

Successfully merged and deployed -- thanks @ericgregory!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants