You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/DEPLOYMENT.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
We deploy the (native) Docker image of all CoMPAS services to Docker Hub. This way, it can be pulled and deployed into environments of your choice (OpenShift for example).
The following instructions are terminal instructions for publishing a Quarkus docker image to Docker Hub. This should be done by a Github Action in the future.
5
+
The following instructions are terminal instructions for publishing a Quarkus docker image to Docker Hub. This should be done by a GitHub Action in the future.
Copy file name to clipboardExpand all lines: docs/DEVELOPING.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -88,7 +88,7 @@ Username should be your GitHub username, password can both be your own [encrypte
88
88
or a [Personal Access Token](https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token).
89
89
90
90
## IDEs
91
-
If your IDE is supported by sonarlint (both IntelliJ IDEA and the Eclipse IDE are supported), it is recommended to install it.
91
+
If your IDE is supported by SonarLint (both IntelliJ IDEA and the Eclipse IDE are supported), it is recommended to install it.
92
92
It provides immediate feedback on most sonar issues. Running tests individually is often possible in IDEs without invoking maven.
93
93
Please consult the documentation of your IDE for setting up the project through maven integration.
Copy file name to clipboardExpand all lines: docs/GITHUB_ACTIONS.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,16 @@
1
-
# Github Actions
2
-
Every repository within the CoMPAS Github organization need a default set of Github Actions.
3
-
[Github Actions](https://github.com/features/actions) are CI/CD steps within a Github Repository that you can configure. This way, you can ensure that certain steps (like building) are always triggered on for example a commit push.
1
+
# GitHub Actions
2
+
Every repository within the CoMPAS GitHub organization need a default set of GitHub Actions.
3
+
[GitHub Actions](https://github.com/features/actions) are CI/CD steps within a GitHub Repository that you can configure. This way, you can ensure that certain steps (like building) are always triggered on for example a commit push.
4
4
5
-
Within CoMPAS, we define the following 'must have' Github Actions:
5
+
Within CoMPAS, we define the following 'must have' GitHub Actions:
6
6
-[Building](#building)
7
7
-[REUSE check](#reuse-check)
8
8
-[SonarCloud](#sonarcloud)
9
9
-[Docker Hub Deployment](#docker-hub-deployment)
10
10
11
11
More to follow.
12
12
13
-
Github Actions are configured using YAML files. These files are stored in the `.github/workflows` directory of a specific repository.
13
+
GitHub Actions are configured using YAML files. These files are stored in the `.github/workflows` directory of a specific repository.
14
14
15
15
## Maven settings.xml during GitHub Action for GitHub Packages
16
16
During multiple GitHub Actions (like building and SonarCloud analysis), the custom `settings.xml` file is needed because it needs access to the GitHub Packages
@@ -65,7 +65,7 @@ jobs:
65
65
66
66
A few points to remember:
67
67
- (1): By default, all actions are triggered on a push action.
68
-
- (2): This step creates a custom settings.xml for authenticating for Github Packages. For more information,
68
+
- (2): This step creates a custom settings.xml for authenticating for GitHub Packages. For more information,
69
69
check the [Contributing file](https://github.com/com-pas/contributing/blob/master/CONTRIBUTING.md).
70
70
- (3): This is a default for building a Maven project. It may differ in some cases, please feel free to adjust it.
71
71
@@ -92,7 +92,7 @@ A few points to remember:
92
92
This is the only thing that has to be done. After this, it will be checked on every push.
93
93
94
94
### REUSE badge
95
-
For transparancy, CoMPAS repositories also include a REUSE badge in their README for fast checking the REUSE compliance.
95
+
For transparency, CoMPAS repositories also include a REUSE badge in their README for fast checking the REUSE compliance.
96
96
97
97
Two steps are needed to get a REUSE badge to work:
98
98
@@ -110,11 +110,11 @@ After doing all these steps, everything is set up for the REUSE check.
110
110
## SonarCloud
111
111
For static code analysis, CoMPAS is using [SonarCloud](https://sonarcloud.io/). To configure this, there are several steps that needs to be done.
112
112
113
-
1. Go to the [CoMPAS Github organization settings](https://github.com/organizations/com-pas/settings/profile), and click on "Installed Github Apps". SonarCloud is listed here already (because we are already using it). Click on the 'configure' button next to it.
113
+
1. Go to the [CoMPAS GitHub organization settings](https://github.com/organizations/com-pas/settings/profile), and click on "Installed GitHub Apps". SonarCloud is listed here already (because we are already using it). Click on the 'configure' button next to it.
114
114
2. In the "Repository access" section, select the repository you want to add. By default, not every repository is added as an extra check.
115
115
3. Create a new project in [SonarCloud](https://sonarcloud.io/projects/create).
116
116
4. Select the repository to be analyzed, click Set Up.
117
-
5. Choose the Analysis Method "With Github Actions".
117
+
5. Choose the Analysis Method "With GitHub Actions".
118
118
6. It first tells you to create a SONAR_TOKEN secret in your repo. Go to your repository -> Settings - Secrets -> New repository secret -> Name: SONAR_TOKEN. Value: Copy the value from the SonarCloud website into here. Then save the secret
119
119
7. Select Maven as the option that best describes our build and **remember the projectKey**. and create a `sonarcloud_analysis.yml` file in the `.github/workflows` directory containing the following source code running.
120
120
@@ -168,7 +168,7 @@ jobs:
168
168
169
169
A few points to remember:
170
170
- (1): By default, all actions are triggered on a push action.
171
-
- (2): Creates a custom `settings.xml` having the credentials for the Github Packages.
171
+
- (2): Creates a custom `settings.xml` having the credentials for the GitHub Packages.
172
172
For more information, check our [Contributing](https://github.com/com-pas/contributing/blob/master/CONTRIBUTING.md).
173
173
- (3): Replace the `<insert project key>` with the project key you copied.
174
174
@@ -219,10 +219,10 @@ jobs:
219
219
```
220
220
221
221
A few points to remember:
222
-
- (1): By default, the docker image is only deployed on release. This way we have a strict deployment flow, and versions always have the same content. For more information about types of releases, check the [Github Actions documentation](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#release).
222
+
- (1): By default, the docker image is only deployed on release. This way we have a strict deployment flow, and versions always have the same content. For more information about types of releases, check the [GitHub Actions documentation](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#release).
223
223
- (2): Before deploying to Docker Hub, we need to login first. This can be done by executing a GitHub Action. In this example, `DOCKER_HUB_USERNAME` and `DOCKER_HUB_PASSWORD` are used, which are secrets stored at [CoMPAS organization](https://github.com/organizations/com-pas/settings/secrets/actions). For more information about the username and password, ask in the the [Slack channel](https://app.slack.com/client/TLU68MTML).
224
224
- (3): Extract the tag name from Git and use that as version to be set with Maven (${{ steps.extract_tagname.outputs.tagname }}).
225
-
- (4): Creates a custom `settings.xml` having the credentials for the Github Packages.
225
+
- (4): Creates a custom `settings.xml` having the credentials for the GitHub Packages.
226
226
For more information, check our [Contributing](https://github.com/com-pas/contributing/blob/master/CONTRIBUTING.md).
227
227
- (5): Building and publishing the docker image is build tool / framework specific. By default, CoMPAS services are using Quarkus and Maven. Deploying to Docker Hub is quite easy using Quarkus and maven, it's just a matter of building in combination with setting some properties. In this example, we use the `quarkus-profile` parameter instead of including all the parameters. This way, we can define profile specific properties in our `application.properties` file (For more information about this, check our [Docker Hub Deployment page](./DEPLOYMENT.md)):
By contributing to the CoMPAS project, you accept and agree to the following terms and conditions for your present and future contributions submitted to CoMPAS.
37
37
38
38
All contributions to this project are licensed under the license stipulated at the corresponding sub-repository.
39
-
Except where otherwise explicitely indicated, CoMPAS is an open source project licensed under the [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0/).
39
+
Except where otherwise explicitly indicated, CoMPAS is an open source project licensed under the [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0/).
40
40
41
41
The project requires the use of the [Developer Certificate of Origin (DCO)](https://developercertificate.org/).
42
42
The DCO is a legally binding statement asserting that you are you have the right to submit your contribution and to license it under the project's applicable license.
@@ -61,15 +61,15 @@ Note that checks will be performed during the integration in order to require th
61
61
62
62
## Community refinements
63
63
64
-
Every monday there is a CoMPAS Community Refinement at 10AM CET. The event is available at the CoMPAS mailing list [calendar](https://lists.lfenergy.org/g/CoMPAS/calendar) and can be subscribed to.
64
+
Every Monday there is a CoMPAS Community Refinement at 10AM CET. The event is available at the CoMPAS mailing list [calendar](https://lists.lfenergy.org/g/CoMPAS/calendar) and can be subscribed to.
65
65
66
66
### Prepared topics
67
67
68
-
Every friday before the refinement meeting on Monday, all topics are published on the #compas channel on our [LFEnergy Slack](https://lfenergy.slack.com/).
68
+
Every Friday before the refinement meeting on Monday, all topics are published on the #compas channel on our [LFEnergy Slack](https://lfenergy.slack.com/).
69
69
70
70
### Add your own topics
71
71
72
-
Everybody can suggest topics for the refinement. To do this, join the [LFEnergy Slack](https://lfenergy.slack.com/) if not already, and put your topics in the #compas channel. You can just do this by writing a message like "I want to add something to the refinement this monday, namely..." or add a comment to the already prepared topics if available (see [Prepared topics](#prepared-topics)).
72
+
Everybody can suggest topics for the refinement. To do this, join the [LFEnergy Slack](https://lfenergy.slack.com/) if not already, and put your topics in the #compas channel. You can just do this by writing a message like "I want to add something to the refinement this Monday, namely..." or add a comment to the already prepared topics if available (see [Prepared topics](#prepared-topics)).
73
73
74
74
### Reporting Bugs and Suggesting Enhancements
75
75
@@ -116,7 +116,7 @@ Continuous integration is set up to run on all branches automatically and will o
116
116
117
117
Continuous integration is setup automatically on all contributions. However, it's faster to iterate locally to fix problems than waiting for the status checks to finish.
118
118
There are many tools that can be used to do the verifications that are enforced by all status checks. The most simple and universal tool is maven, but IDE integrations
119
-
can be used to get more immediate feedback. Most of the team uses IntelliJ IDEA, but others IDEs can be used, for exemple the Eclipse IDE.
119
+
can be used to get more immediate feedback. Most of the team uses IntelliJ IDEA, but others IDEs can be used, for example the Eclipse IDE.
120
120
121
121
### Definition of Done
122
122
@@ -144,7 +144,7 @@ On the [developing](DEVELOPING.md) page information about tooling can be found.
144
144
145
145
#### Open Community Calls
146
146
147
-
It's good to know that every other monday, we are having a so called Open Community Call. Everyone participating in the CoMPAS project can join
147
+
It's good to know that every other Monday, we are having a so called Open Community Call. Everyone participating in the CoMPAS project can join
148
148
and talk about and ask question about the CoMPAS project.
149
149
150
150
When the Open Community Calls are taking place, can be found at the [General CoMPAS mailing list calendar](https://lists.lfenergy.org/g/CoMPAS/calendar).
@@ -157,7 +157,7 @@ If you have something to add, please add it to the agenda and notify everyone on
157
157
158
158
One of the first important things, is to meet the community. Feel free to introduce yourself by joining the channel 'compas' on [LF Energy Slack](https://slack.lfenergy.org/)!
159
159
160
-
The Slack channel is the first communication platform within the CoMPAS project (besides email and the Github platform), so if you need help for example you can use Slack!
160
+
The Slack channel is the first communication platform within the CoMPAS project (besides email and the GitHub platform), so if you need help for example you can use Slack!
161
161
162
162
#### Documenting
163
163
A good (open source) project requires documentation. We have two places for our documentation
@@ -170,33 +170,33 @@ about CoMPAS in general (like roadmap and the community call agendas).
170
170
#### Architecture and technologies
171
171
172
172
For all architecture and technology choices (for example frameworks, build tools, database choices, etcetera),
173
-
please check the source code (duh!) and our [CoMPAS Architecture Github Pages](https://com-pas.github.io/compas-architecture/).
173
+
please check the source code (duh!) and our [CoMPAS Architecture GitHub Pages](https://com-pas.github.io/compas-architecture/).
174
174
175
175
### Copyright and Licensing
176
176
177
177
Copyright and license information is done on per-file basis. We use the specification of [REUSE](https://reuse.software/spec/)
178
-
to ensure that copyright information of the project is clear and can be analuzed in an automated fashion.
178
+
to ensure that copyright information of the project is clear and can be analyzed in an automated fashion.
179
179
180
-
Every source code repository within CoMPAS has a Github Action for checking against the REUSE specification.
180
+
Every source code repository within CoMPAS has a GitHub Action for checking against the REUSE specification.
181
181
182
182
For more information, check the [Copyright Guidelines](STYLEGUIDE.md#copyright-guidelines) section.
183
183
184
-
### Github Project Boards
184
+
### GitHub Project Boards
185
185
186
186
For managing the CoMPAS issues created in all the separate repositories, we use the [Projects Board](https://github.com/orgs/com-pas/projects) of Github.
187
187
CoMPAS uses 2 different Project Boards: One for [Pull Requests](https://github.com/orgs/com-pas/projects/2) and one for the [Issues](https://github.com/orgs/com-pas/projects/1).
188
188
189
189
When creating Pull Requests or Issues, it will automatically create issues or Pull Requests on the Project Boards.
190
-
This is done by the Automate Projects Github Action (take a look at the [action from the Data Service](https://github.com/com-pas/compas-core/blob/master/.github/workflows/automate-projects.yml) for example).
191
-
Changing the status of Issues / Pull Requests is also handled automatically by the Github Action.
190
+
This is done by the Automate Projects GitHub Action (take a look at the [action from the Data Service](https://github.com/com-pas/compas-core/blob/master/.github/workflows/automate-projects.yml) for example).
191
+
Changing the status of Issues / Pull Requests is also handled automatically by the GitHub Action.
192
192
193
193
Issues and Pull Requests can be moved on both the Project Boards and on the boards of the specific repository itself. It synchronizes automatically.
194
194
195
-
## Github Pages
195
+
## GitHub Pages
196
196
197
-
This site is provided as a [github pages site](https://com-pas.github.io/contributing/).
198
-
The content is maintained and edited on [Github](https://github.com/com-pas/contributing) in the directory "docs".
199
-
Contributors are only allowed to contribute by editing the content on Github and must do so by presenting their modifications as *pull-request* to the community.
197
+
This site is provided as a [GitHub pages site](https://com-pas.github.io/contributing/).
198
+
The content is maintained and edited on [GitHub](https://github.com/com-pas/contributing) in the directory "docs".
199
+
Contributors are only allowed to contribute by editing the content on GitHub and must do so by presenting their modifications as *pull-request* to the community.
200
200
The diagrams on this page are created using [DrawIO](https://github.com/jgraph/drawio-desktop/releases)
201
201
and follow [Unified Modeling Language (UML)](https://www.omg.org/spec/UML/).
202
202
The drawIO design file is available on this site: [/blob-files/CoMPAS.drawio](blob-files/CoMPAS.drawio).
0 commit comments