Revise and update Contribute page and make it easier to find on website

lauracowen commented 4 years ago

(Raised on behalf of @gcharters .)

The homepage has a contribute button at the end of the page which takes you to the contribute page which takes you to the contributing guidelines (CONTRIBUTING.MD; which you can also get to from the open-liberty repo readme). But it's not clear where to go from that page to get started with the code. The README.md in the repo does at least have some instructions on forking the repo. The issue is there are mutliple entry points for different types on contribution and some aren't joined even thought they're related. I think we need one way in 'contribute' that then fans out to different types of contribution and clearly describes how to go about doing each of those. For example, at the moment "fork the code" ribbon goes straight into the open-liberty repo. And the website Contribute page says fix a bug but with no way to know how to start doing that.

Laura:

Suggest we update the content on the Contribute page to pull together the different ways in which you can contribute, inc docs and guides which have their own contribution instructions now.
Make sure it's clear how to set up a dev/build environment for the OL runtime code, or what you need for other types of contribution.
It's not clear how people are meant to discover the open-liberty wiki where a lot of our dev/build doc is located: https://github.com/openliberty/open-liberty/wiki
~Change the "fork the code" ribbon to say something more helpful like "Contribute to Open Liberty" and link to the Contribute page? (don't like the 'fork the code' ribbon text anyway)~ Fork the code has already been removed from the header.

gcharters commented 4 years ago

From discussion with @lauracowen, we think the following sections are needed, in this order:

Raise a bug
Contribute to docs
Contribute to guides
Write a blog post
Fix a bug
Write a new feature

Each should point of to the appropriate place for how to get started doing these.

mbroz2 commented 4 years ago

@mbroz2 and @yeekangc will provide the content/layout for this page.

steven1046 commented 1 year ago

The link to open issues on https://openliberty.io/support/ opens an issue on the website repo and not the open-liberty repo.

takes you to https://github.com/OpenLiberty/openliberty.io/issues

lauracowen commented 1 year ago

@steven1046 Should that be pulled out as a separate issue (bug) to be fixed regardless of what happens with this issue?

steven1046 commented 1 year ago

@lauracowen yes, i'll open a separate issue

OpenLiberty / openliberty.io

Revise and update Contribute page and make it easier to find on website #1850