Skip to content

Commit 0862f93

Browse files
committed
Added contribution guide
1 parent 7898ff3 commit 0862f93

File tree

2 files changed

+425
-24
lines changed

2 files changed

+425
-24
lines changed

CONTRIBUTING.md

+25-24
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,3 @@
1-
#-------------------------------------------------------------------------------
2-
# Copyright 2021-2022 Amit Kumar Mondal
3-
#
4-
# Licensed under the Apache License, Version 2.0 (the "License"); you may not
5-
# use this file except in compliance with the License. You may obtain a copy
6-
# of the License at
7-
#
8-
# http://www.apache.org/licenses/LICENSE-2.0
9-
#
10-
# Unless required by applicable law or agreed to in writing, software
11-
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12-
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13-
# License for the specific language governing permissions and limitations under
14-
# the License.
15-
#-------------------------------------------------------------------------------
161
# How to Contribute
172

183
First of all, thanks for considering to contribute. We appreciate the time and effort you want to
@@ -28,17 +13,18 @@ Here is a (non-exclusive, non-prioritized) list of things you might be able to h
2813
* tests
2914

3015
### File Headers
16+
3117
A proper header must be in place for any file contributed to the project. For a new contribution, please add the below header:
3218

3319
```
3420
/*
35-
* Copyright (c) <year> <legal entity> and others
21+
* Copyright (c) <year> <legal entity> and others
3622
*
3723
* Licensed under the Apache License, Version 2.0 (the "License");
3824
* you may not use this file except in compliance with the License.
3925
* You may obtain a copy of the License at
4026
*
41-
* http://www.apache.org/licenses/LICENSE-2.0
27+
* http://www.apache.org/licenses/LICENSE-2.0
4228
*
4329
* Unless required by applicable law or agreed to in writing, software
4430
* distributed under the License is distributed on an "AS IS" BASIS,
@@ -48,19 +34,19 @@ A proper header must be in place for any file contributed to the project. For a
4834
*/
4935
```
5036

51-
Please ensure \<year\> is replaced with the current year or range (e.g. 2017 or 2015, 2017).
52-
Please ensure \<legal entity\> is replaced with the relevant information. If you are editing an existing contribution, feel free
37+
Please ensure `<year>` is replaced with the current year or range (e.g. 2017 or 2015, 2017).
38+
Please ensure `<legal entity>` is replaced with the relevant information. If you are editing an existing contribution, feel free
5339
to create or add your legal entity to the contributors section as such:
5440

5541
```
5642
/*
57-
* Copyright (c) <year> <legal entity> and others
43+
* Copyright (c) <year> <legal entity> and others
5844
*
5945
* Licensed under the Apache License, Version 2.0 (the "License");
6046
* you may not use this file except in compliance with the License.
6147
* You may obtain a copy of the License at
6248
*
63-
* http://www.apache.org/licenses/LICENSE-2.0
49+
* http://www.apache.org/licenses/LICENSE-2.0
6450
*
6551
* Unless required by applicable law or agreed to in writing, software
6652
* distributed under the License is distributed on an "AS IS" BASIS,
@@ -84,8 +70,7 @@ You do this by adding the `-s` flag when you make the commit(s), e.g.
8470

8571
* Fork the repository on GitHub
8672
* Create a new branch for your changes
87-
* Configure your IDE installing:
88-
* [SonarLint](http://www.sonarlint.org/eclipse/index.html)
73+
* Configure your IDE
8974
* Make your changes
9075
* Make sure copyright headers are included in (all) files including updated year(s)
9176
* Make sure proper headers are in place for each file (see above Legal Requirements)
@@ -95,9 +80,25 @@ You do this by adding the `-s` flag when you make the commit(s), e.g.
9580
* Make sure you use the `-s` flag when committing as explained above
9681
* Push your changes to your branch in your forked repository
9782

83+
## Importing projects in Eclipse IDE
84+
85+
* Install `Java 17` JDK Distribution (including JavaFX modules) in your machine (Currently I am using [Zulu Distribution](https://www.azul.com/downloads/?version=java-17-lts&package=jdk-fx#zulu) that includes JavaFX modules already)
86+
* Set the newly installed `Java 17` to your `JAVA_HOME`
87+
* Install `Eclipse IDE for RCP/RAP Developers` and make sure your Eclipse installation uses the currently installed `Java 17` to start with
88+
* Install `Bndtools`, `e(fx)clipse`, and `SonarLint` from Eclipse Marketplace
89+
* Go to `Java ⇢ Compiler` in `Eclipse Preferences` and set `Compiler Compliance Level` to `17`
90+
* Go to `Java ⇢ Installed JREs` and select the newly installed JDK with JavaFX modules
91+
* Go to `Java ⇢ Installed JREs ⇢ Execution Environments` and select `JavaSE-17` and choose the recently installed `Java 17 JRE` that includes `JavaFX` modules
92+
* Go to `Java ⇢ Code Style ⇢ Formatter ⇢ Import` and select the `formatter.xml` stored in the project's root directory
93+
* Import all the projects (`File ⇢ Import ⇢ General ⇢ Existing Projects into Workspace` and select `Search for nested projects`)
94+
95+
## Verify your changes
96+
97+
* To start the application inside IDE, go to `com.osgifx.console.product` and double click on `osgifx.bndrun`. This will open the `bndrun editor` and then click on `Debug OSGi` from the top right corner.
98+
9899
## Submitting the Changes
99100

100-
Submit a pull request via the normal GitHub UI.
101+
Submit a pull request via the normal GitHub UI
101102

102103
## After Submitting
103104

0 commit comments

Comments
 (0)