Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 13 additions & 4 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Contributing

Welcome to Galasa! To learn more about contributing to this repository, please read this Contributor's Guide.
Welcome to Galasa! To learn more about contributing to the Galasa project, please read this Contributor's Guide.

## How can you contribute?

Expand All @@ -19,7 +19,8 @@ Welcome to Galasa! To learn more about contributing to this repository, please r
### Contributing code

- Ensure your contribution aligns with the project's roadmap.
- Check out open issues with the label `good first issue`.
- Check out open issues on [our Kanban board](https://github.com/orgs/galasa-dev/projects/3), especially ones with the label `good first issue`.
- Other common labels include `webui`, `cli` or `REST API`. Typically, stories without one of these three tags will imply it's a change needing to be made to this repository.

### Abide by the contributions legal guidance
To ship, all developer contributions must abide by the legal guidance detailed in the [Developer Certificate of Origin](./CONTRIBUTIONS.md)
Expand All @@ -28,7 +29,7 @@ To ship, all developer contributions must abide by the legal guidance detailed i

- Fix typos, improve examples, or enhance explanations.

## How to make a contribution?
## How to make a contribution to this Repository

### Sign your commits

Expand All @@ -40,7 +41,7 @@ This allows us to prove who made each change to the codebase.
Each PR build has "Developer Certificate of Origin" [DCO](./CONTRIBUTIONS.md) checking turned on, so nothing will get
delivered without signed commits.

If you forgot to sign one or all of your commits, you can squash your PR changes and force-push your branch.
If you forgot to sign one or all of your commits, you can squash your PR changes, sign them, then force-push your branch.

### Set up a fork of a repository

Expand Down Expand Up @@ -230,3 +231,11 @@ git commit -s -S -m "Add a meaningful commit message"
git push origin issue-number/contribution-description
```
6. Open a pull request from your forked repository branch to the main branch of the 'galasa repository', and explain your changes. Refer to any stories which are relevent and explain why the change was made, what the change is, and anything else which reviewers would find helpful to understand the context of the change.

## How to make a contribution to Galasa's webui

1. Similarly to the this repository, you must [fork the respository](#set-up-a-fork-of-a-repository) and [sign your commits](#sign-your-commits).

2. Having access to a Galasa service can help aid development of the web UI by removing the need to set up additional back-end services locally. To get access, please [sign up](https://github.com/orgs/galasa-dev/teams/galasa-service1-users) to be a part of the galasa-service1-users team on Github. On that page there should be a request to join button. This will send a request to one of the maintainers, so please reach out to the Galasa team via our support channels (see https://galasa.dev/support) otherwise your request will be denied. Alternatively, you could also read out directly on a ticket you would like to work on from [our Kanban board](https://github.com/orgs/galasa-dev/projects/3). Next, go to https://galasa-service1.galasa.dev/ which will get you to authenticate via GitHub, then you'll be added to the system with the 'viewer' role.

3. After you've confirmed you have access to a Galasa service, please refer back to the [webui's readme.md](https://github.com/galasa-dev/webui/blob/main/README.md) to setup environment variables such as `GALASA_DEV_TOKEN`, `GALASA_API_SERVER_URL` and `NODE_EXTRA_CA_CERTS` or `NODE_USE_SYSTEM_CA`, then run the project as chosen.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ When setting up galasa locally, you can either use [(1) our development containe
### (2) Manual set up

Some tools will need to be installed in order to build this code locally.
See our install instructions [here](./developer-docs/install-pre-req-tools.md)
See our install instructions [here](./developer-docs/install-pre-req-tools.md).


### To build...
Expand Down
Loading