Improve the readme #35691
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -3,7 +3,7 @@ | |||||||||
| [](https://codecov.io/gh/nextcloud/server) | ||||||||||
| [](https://bestpractices.coreinfrastructure.org/projects/209) | ||||||||||
|
|
||||||||||
| **Regain control over your data** | ||||||||||
|
|
||||||||||
|  | ||||||||||
|
|
||||||||||
|
|
@@ -12,19 +12,19 @@ | |||||||||
| * 📁 **Access your Data** You can store your files, contacts, calendars, and more on a server of your choosing. | ||||||||||
| * 🔄 **Sync your Data** You keep your files, contacts, calendars, and more synchronized amongst your devices. | ||||||||||
| * 🙌 **Share your Data** …by giving others access to the stuff you want them to see or to collaborate with. | ||||||||||
| * 🚀 **Expandable with hundreds of Apps** ...like [Calendar](https://github.com/nextcloud/calendar), [Contacts](https://github.com/nextcloud/contacts), [Mail](https://github.com/nextcloud/mail), [Video Chat](https://github.com/nextcloud/spreed) and all those you can discover in our [App Store](https://apps.nextcloud.com). | ||||||||||
| * 🔒 **Security** with our encryption mechanisms, [HackerOne bounty program](https://hackerone.com/nextcloud) and two-factor authentication. | ||||||||||
|
|
||||||||||
| Do you want to learn more about how you can use Nextcloud to access, share and protect your files, calendars, contacts, communication and more at home and/or in your organization? [**Learn about all our Features**](https://nextcloud.com/hub/). | ||||||||||
|
|
||||||||||
| ## Get your Nextcloud 🚚 | ||||||||||
|
|
||||||||||
| - ☑️ [**Simply sign up**](https://nextcloud.com/signup/) with one of our providers either through our website or through our apps directly. | ||||||||||
| - 🖥 [**Install**](https://nextcloud.com/install/#instructions-server) a server by yourself on your hardware. | ||||||||||
jospoortvliet marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||||||
| - 📦 Buy one of the awesome [**devices listed here**](https://nextcloud.com/devices/) with Nextcloud preinstalled. | ||||||||||
| - 🏢 Find a [**service provider**](https://nextcloud.com/providers/) who can host Nextcloud for you or for your company. | ||||||||||
|
|
||||||||||
| Are you in the Private Sector, Public Sector, or Education? You may want to have a look into [**Nextcloud Enterprise**](https://nextcloud.com/enterprise/) provided by Nextcloud GmbH. | ||||||||||
|
|
||||||||||
| ## Get in touch 💬 | ||||||||||
|
|
||||||||||
|
|
@@ -33,28 +33,30 @@ Enterprise? Public Sector or Education user? You may want to have a look into [* | |||||||||
| * [🐣 Twitter](https://twitter.com/Nextclouders) | ||||||||||
| * [🐘 Mastodon](https://mastodon.xyz/@nextcloud) | ||||||||||
|
|
||||||||||
| You can also [get support from Nextcloud](https://nextcloud.com/support)! | ||||||||||
clivinghouse marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||||||
|
|
||||||||||
|
|
||||||||||
| ## Join the team 👪 | ||||||||||
|
|
||||||||||
| There are many ways to contribute, of which development is only one! Find out [how to get involved](https://nextcloud.com/contribute/). This includes a translator, designer, tester, helping others, and much more! 😍 | ||||||||||
|
|
||||||||||
|
|
||||||||||
| ### Development setup 👩💻 | ||||||||||
|
|
||||||||||
| 1. 🚀 [Set up your local development environment.](https://docs.nextcloud.com/server/latest/developer_manual/getting_started/devenv.html) | ||||||||||
| 2. 🐛 [Pick a good first issue.](https://github.com/nextcloud/server/labels/good%20first%20issue) | ||||||||||
| 3. 👩🔧 Create a branch and make your changes. Remember to sign off your commits using `git commit -sm "Your commit message"`. | ||||||||||
| 4. ⬆ Create a [pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) and `@mention` the people from the issue to review. | ||||||||||
| 5. 👍 Fix things that come up during a review. | ||||||||||
| 6. 🎉 Wait for it to get merged! | ||||||||||
|
|
||||||||||
| Third-party components are handled as git submodules which have to be initialized first. Git checkout invoking `git submodule update --init` or a similar command is needed, for details see [Git documentation](https://git-scm.com/docs/user-manual). | ||||||||||
|
There was a problem hiding this comment. The sentence lost its meaning, it was only missing a comma after «invoking» There was a problem hiding this comment. I can see your point.
Suggested change
Do you agree to adding a link to the git documentation? There was a problem hiding this comment. But in what you propose, you put the comma wrong. People need to invoke the command 'git submodule' etc, so the coma should be after 'checkout', not after invoking:
There was a problem hiding this comment.
Suggested change
so like this @jospoortvliet? |
||||||||||
|
|
||||||||||
| Several apps that are included by default in regular releases such as [First run wizard](https://github.com/nextcloud/firstrunwizard) or [Activity](https://github.com/nextcloud/activity) are missing in `master` and have to be installed manually by cloning them into the `apps` subfolder. | ||||||||||
|
|
||||||||||
| Otherwise, git checkouts can be handled the same as release archives, by using the `stable*` branches. | ||||||||||
|
|
||||||||||
| ⚠️WARNING⚠️ **they should never be used on production systems.** | ||||||||||
|
|
||||||||||
| ### Working with front-end code 🏗 | ||||||||||
|
|
||||||||||
|
|
||||||||||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not our apps, the one of the providers I think
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
When the sentence talks about signing up, it gives the option of going to the Nextcloud signup page or through "... the apps directly..." i am assuming it means our IOS/Android app. is this sentence to mean
if it is to mean our IOS/Android App, then maybe it should be more consice
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No, the change is correct, it's OUR apps (android, iOS, desktop) through which you can sign up with a third party provider ;-) So this is actually good.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
would this be good then? @jospoortvliet