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: CONTRIBUTING.md
+13-22Lines changed: 13 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,29 +1,24 @@
1
1
## Submitting issues
2
2
3
-
If you have questions about how to use ownCloud, please join our [rocket chat channel][rocketchat] or our [forum][forum].
3
+
If you have questions about how to use OpenCloud, please join our matrix channel.
4
4
5
5
### Guidelines
6
-
*[Report the issue](https://github.com/owncloud/android/issues/new) using on of our [templates][template], they include all the information we need to track down the issue.
7
-
* This repository is *only* for issues within the ownCloud Android app code. Issues in other components should be reported in their own repositories:
Thanks for wanting to contribute source code to ownCloud. That's great!
19
+
Thanks for wanting to contribute source code to OpenCloud. That's great!
25
20
26
-
Before we're able to merge your code into the ownCloud app for Android, please, check the [contribution guidelines][contribution].
21
+
Before we're able to merge your code into the OpenCloud app for Android, please, check the contribution guidelines.
27
22
28
23
### Guidelines
29
24
* Contribute your code in a feature, fix, improvement or technical enhancement branch by using one of the following branch names:
@@ -36,7 +31,7 @@ Before we're able to merge your code into the ownCloud app for Android, please,
36
31
Please, use the mentioned prefixes because CI system is ready to match with them. Be sure your feature, fix, improvement or technical branches are updated with latest changes in official `android/master`, it will give us a better chance to test your code before merging it with stable code.
37
32
* Once you are done with your code, start a pull request to merge your contribution into official `android/master`.
38
33
* Keep on using pull requests for your next contributions although you own write permissions.
39
-
* Important to mention that ownCloud Android team uses OneFlow as branching model. It's something as useful as easy:
34
+
* Important to mention that ÒpenCloud Android team uses OneFlow as branching model. It's something as useful as easy:
40
35
41
36
*`master` will stay as main branch. Everything will work around it.
42
37
* Feature branch: new branch created from `master`. Once it is finished and DoD accomplished, rebased and merged into `master`.
@@ -46,16 +41,12 @@ Before we're able to merge your code into the ownCloud app for Android, please,
46
41
47
42
Interesting [link](https://www.endoflineblog.com/oneflow-a-git-branching-model-and-workflow) about this.
48
43
49
-
[contribution]: https://owncloud.com/contribute/
50
-
51
44
### 1. Fork and download android/master repository:
52
45
53
-
* Please follow [SETUP.md](https://github.com/owncloud/android/blob/master/SETUP.md) to setup ownCloud Android app work environment.
46
+
* Please follow [SETUP.md](https://github.com/opencloud-eu/android/blob/master/SETUP.md) to setup OpenCloud Android app work environment.
54
47
55
48
### 2. Create pull request:
56
49
57
-
NOTE: You must sign the [CLA](https://cla-assistant.io/owncloud/android) before your changes can be accepted!
58
-
59
50
* Create new feature, fix, improvement or technical enhancement branch from your master branch: ```git checkout -b feature/feature_name```
60
51
* Register your changes: `git add filename`
61
52
* Commit your changes locally. Please, if posible use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) to add descriptive messages to the commits. Take the simplest approach:
@@ -89,9 +80,9 @@ In order to check or review the stable versions, all available tags can be fetch
89
80
## Translations
90
81
Please submit translations via [Transifex][transifex].
Please, read the [ownCloud code of conduct]. Being respectful and polite with other members of the community and staff is necessary to develop a better product together.
86
+
Please, read the [code of conduct]. Being respectful and polite with other members of the community and staff is necessary to develop a better product together.
96
87
97
-
[ownCloud code of conduct]: https://owncloud.com/contribute/code-of-conduct/
|master (Unit tests and data instrumented tests)||
11
+
|master (Unit tests and data instrumented tests)||
**Start contributing:** Make sure you read [SETUP.md](https://github.com/owncloud/android/blob/master/SETUP.md) when you start working on this project. Basically: Fork this repository and contribute back using pull requests to the master branch.
18
-
Easy starting points are also reviewing [pull requests](https://github.com/owncloud/android/pulls) and working on [contributions are welcome](https://github.com/owncloud/android/issues?q=is%3Aopen+is%3Aissue+label%3A%22Contributions+are+welcome%22).
**Start contributing:** Make sure you read [SETUP.md](https://github.com/opencloud-eu/android/blob/master/SETUP.md) when you start working on this project. Basically: Fork this repository and contribute back using pull requests to the master branch.
17
+
Easy starting points are also reviewing [pull requests](https://github.com/opencloud-eu/android/pulls) and working on [contributions are welcome](https://github.com/opencloud-eu/android/issues?q=is%3Aopen+is%3Aissue+label%3A%22Contributions+are+welcome%22).
Copy file name to clipboardExpand all lines: SETUP.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
### Setup Information
2
2
3
-
These instructions will help you to set up your development environment, get the source code of the ownCloud for Android app and build it by yourself. If you want to help developing the app take a look to the [contribution guidelines][0].
3
+
These instructions will help you to set up your development environment, get the source code of the OpenCloud for Android app and build it by yourself. If you want to help developing the app take a look to the [contribution guidelines][0].
4
4
5
5
Sections 1) and 2) are common for any environment. The rest of the sections describe how to set up a project in different tool environments. Nowadays we recommend to use Android Studio (section 2), but you can also build the app from the command line (section 3).
6
6
@@ -11,33 +11,33 @@ If you have any problem, remove the 'android' folder, start again from 1) and wo
11
11
12
12
There are some tools needed, no matter what is your specific IDE or build tool of preference.
13
13
14
-
[git][1] is used to access to the different versions of the ownCloud's source code. Download and install the version appropriate for your operating system from [here][2]. Add the full path to the 'bin/' directory from your git installation into the PATH variable of your environment so that it can be used from any location.
14
+
[git][1] is used to access to the different versions of the OpenCloud's source code. Download and install the version appropriate for your operating system from [here][2]. Add the full path to the 'bin/' directory from your git installation into the PATH variable of your environment so that it can be used from any location.
15
15
16
16
The [Android SDK][3] is necessary to build the app. There are different options to install it in your system, depending of the IDE you decide to use. Check Google documentation about [installation][4] for more details on these options. After installing it, add the full path to the directories 'tools/' and 'platform-tools/' from your Android SDK installation into the PATH variable of your environment.
17
17
18
-
Open a terminal and type 'android' to start the Android SDK Manager. To build the ownCloud for Android app you will need to install at least the next SDK packages:
18
+
Open a terminal and type 'android' to start the Android SDK Manager. To build the OpenCloud for Android app you will need to install at least the next SDK packages:
19
19
20
20
* Android SDK Tools and Android SDK Platform-tools (already installed); upgrade to their last versions is usually a good idea.
21
21
* No longer need to specify a version for the build tools, Gradle plugin uses the minimum required version by default.
22
-
* Android 12.0 (API 31), SDK Platform; needed to build the owncloud app.
22
+
* Android 12.0 (API 31), SDK Platform; needed to build the OpenCloud app.
23
23
24
24
Install any other package you consider interesting, such as emulators.
25
25
26
26
For other software dependencies check the details in the section corresponding to your preferred IDE or build system.
27
27
28
28
29
-
### 1. Fork and download the owncloud/android repository.
29
+
### 1. Fork and download the opencloud-eu/android repository.
30
30
31
-
You will need [git][1] to access to the different versions of the ownCloud's source code. The source code is hosted in Github and may be read by anybody without needing a Github account. You will need a Github account if you want to contribute to the development of the app with your own code.
31
+
You will need [git][1] to access to the different versions of the OpenCloud's source code. The source code is hosted in Github and may be read by anybody without needing a Github account. You will need a Github account if you want to contribute to the development of the app with your own code.
32
32
33
33
Next steps will assume you have a Github account and that you will get the code from your own fork.
34
34
35
-
* In a web browser, go to https://github.com/owncloud/android, and click the 'Fork' button near the top right corner.
35
+
* In a web browser, go to https://github.com/opencloud-eu/android, and click the 'Fork' button near the top right corner.
36
36
* Open a terminal and go on with the next steps in it.
37
37
* Clone your forked repository: ```git clone https://github.com/YOURGITHUBNAME/android.git```.
38
38
* Move to the project folder with ```cd android```.
39
39
* Fetch and apply any changes from your remote branch 'master': ```git fetch``` + ```git rebase```
40
-
* Make official ownCloud repo known as upstream: ```git remote add upstream https://github.com/owncloud/android.git```
40
+
* Make official OpenCloud repo known as upstream: ```git remote add upstream https://github.com/opencloud-eu/android.git```
41
41
* Make sure to get and apply the latest changes from official android/master branch: ```git fetch upstream``` + ```git rebase upstream/master```
42
42
43
43
At this point you can continue using different tools to build the project. Section 2 and 3 describe the existing alternatives.
@@ -69,7 +69,7 @@ The first time the Gradle wrapper is called, the correct Gradle version will be
69
69
The generated APK file is saved in android/build/outputs/apk as android-debug.apk
0 commit comments