From Fedora Project Wiki

Revision as of 16:06, 9 March 2017 by Bowlofeggs (talk | contribs) (→‎Getting started: Add more instructions to the getting started page)

Welcome, and thank you for your interest in Bodhi for Outreachy 2017. This page will outline some tasks you should perform to apply to work on Bodhi.


Bodhi

Bodhi is the Fedora Project's system for releasing software updates. It allows developers to propose updates for Fedora, and it allows community testers to try those updates out before they are released so they can report back whether they worked or not through a +1/-1 voting system known as karma.


Getting started

You will need to run Fedora for this internship. It is strongly recommended that you use a physical machine for this so that you can use Vagrant. You can read about how to install Fedora here:

https://docs.fedoraproject.org/en-US/Fedora/25/html/Installation_Guide/

The next step will be to install git and clone a copy of Bodhi. Before running these commands, you should cd into a directory that you want to keep your code in, such as ~/devel/:

 $ sudo dnf install git
 $ git clone https://github.com/fedora-infra/bodhi.git
 $ cd bodhi

The easiest way to get started with Bodhi is to use Vagrant. Vagrant allows you to type some simple commands and have a virtual machines automatically built for you that will have Bodhi running and ready for hacking! Bodhi has documentation on how to install Vagrant and get a development environment here:

https://github.com/fedora-infra/bodhi/blob/develop/docs/developer_docs.rst#vagrant

The documentation assumes you are using Fedora on a hardware installation that has virtualization extensions enabled. If your computer doesn't have them enabled and does support them, you will need to go into your BIOS settings and turn it on. If you don't wish to work with Vagrant and have moderate experience with Python and virtualenvs, you can also configure a Bodhi development environment that way:

https://github.com/fedora-infra/bodhi/blob/develop/docs/developer_docs.rst#virtualenv