A collection of Md files for beginner workshop for getting started with contributing to Nextcloud. Made as part of the Nextcloud conference 2018.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images
setupGuides
README.md
partII.md
partIII.md
program.md

README.md

💻 Contributing To Nextcloud Introductory Workshop

Nextcloud

Interested in contributing to Nextcloud but not sure how? In this introductory workshop we will guide you in getting your development environment set up and starting your pull request.

This workshop is being run with support from Open Source Diversity, a monthly Meetup group in Berlin that provides a friendly and safe environment for contributing to open source.

We look forward to getting you started with contributing to Nextcloud Open Source software!


☁️ Nextcloud ☁️

Nextcloud at it's core is a open source self hosted file sharing software but it also offers a lot more. With additional apps you can not only manage your data but interact with it in a collaborative and creative manner with upmost privacy & security!

You can learn more about Nextcloud including how to install it and where to get self hosting on their website : https://nextcloud.com/


Back to Top

👩 Contribute 👨

"Contributing to open source can be a rewarding way to learn, teach, and build experience in just about any skill you can imagine." ~ https://opensource.guide/how-to-contribute/

An open source project is all about its contributors. Over 1000 people have code in Nextcloud. About a 10th of those have direct access to the code in the repository, contributing regularly. Besides coders, there are designers, Nextcloud advocates, translators, forum admins and many others who are part of the community.

With so many ways to get involved, what are you waiting for 😄

Ways to contribute to Nextcloud

  • Develop your own App
  • Improve existing Nextcloud code (if your new to software development, good first issues are a good place to start)
  • Review new code
  • Help with translations
  • Help with the Design (go to the design page)
  • Test the software (Testing upcoming Nextcloud Server releases is the best way of making sure the new release can do what you need it to do. And of course, only if you report a problem to us we know about it and can fix it! If you have a bug to report, find the issue submission page.)

You can show publically on your Github account that you contribute to Nextcloud by setting yourself as public in the GitHub organization

For more details about contirbuting to Nextcloud visit : https://nextcloud.com/contribute/


Back to Top

🖊 Tools you will need

You will also need a few other useful tools to contribute which we will cover here.

📢 IRC Chat

On IRC you can connect to other contributors and ask questions. You can also help others with their code.

There are a few chat tools you can use we reccomend Riot

You'll need to register your username first in order to use our channels. You can find instructions here: https://gist.github.com/fstab/ce805d3001600ac147b79d413668770d

You can then access the Nextcloud developers room through this link: https://riot.im/app/#/room/#freenode_#nextcloud-dev:matrix.org

:octocat: Github & Github Desktop

In order to contribute to the code base and checkout the latest versions you will need to make a free github account, if you don't already have one you can sign up here

https://github.com/nextcloud

Commands to download and upload code can be done through the terminal (on windows you will also need to install git)

Alternatively you can use the Github Desktop GUI which you can download here (we can highly reccomend this for complete beginners to Git)

💎 IDE / Text Editor

To work on the code base you will need a IDE or Text Editor. Here the choice is completely yours and it is a personal preference which you find best to work with. However we can highly recommend Visual Studio Code below are also some others you may like to try (they are all free)

📘 Nextcloud Documentation

Nextcloud already has a vast amount of documentation for getting started, style guides and about how the code base is structured. You need to make sure you are working within these guidelines when you are fixing issues so it is very useful to keep them at hand!

https://docs.nextcloud.com/server/14/developer_manual/

This also includes their code of conduct, if you encounter behaviour aimed at yourself or other that goes against this code do not be afraid to report it! https://docs.nextcloud.com/server/14/developer_manual/general/code-of-conduct.html


Back to Top

📝 Running the Nextcloud development environment

You'll need to set up your development environment to test and program on the Nextcloud codebase. The following guides are to get you started depending on which OS you are using. For Mac and Linux you can run this natively on your machine, for Windows you will have to install a Virtual Machine or for all three you can use the Docker setup we have prepared to run the environment in a isolated container.

For this workshop we reccomend working with Docker so please follow the official set up guide to install Docker on your machine.

🐳 https://www.docker.com/get-started 🐳

We will take time to go through these guides with you shortly as each set up can be a little different and challenging. (we've all been there at some point 😉 )

Big thanks to @jancborchardt & @David-Development for their support in creating these documents


Back to Top

If you didn't follow the Docker guide you will still need to get the code, here is a quick guide to doing so with Github either in the Terminal or through github Desktop

🔢 Through the Terminal

Cloning a Repo to your machine

To start working on an issue or a feature for a repository (nextcloud server or one of the app for example) you will need to download (clone) the project to your local setup.

git clone https://github.com/nextcloud/server

Forking a Repo

Usually you don't have permissions to a repository that does not belong to you. To allow you to edit the code, you can fork the repository to your own account. That means you can clone the project and start coding on your account.

forkbutton

After that just make your changes directly to your own forked repository and you will be able to create a pull request to the original project afterwise.

Creating your own Branch

On your local clone, you will need to create a new branch to start adding your modifications. Just checkout the branch you want to edit (usually master)

git checkout master

and then create a new branch based on the one we just selected

git checkout -B your-branch-name


Back to Top

:octocat: Through the Github Desktop client

Go to clone

drawing

drawing

Respositories > Open in visual studio code

Changes made to the code will appear in the right hand side of the Desktop client

You can create your own branch and publish it to the repo

drawing

You can add a commit message and push your commit to the chosen branch.

drawing

Back to Top

🍎 Now we will take time to make sure you have everything set up and take a short break. Afterwards, we will go to part 2