.. Fedora Infrastructure documentation master file, created by
   sphinx-quickstart on Wed Jan 25 17:17:34 2017.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

===================================
Fedora Infrastructure Documentation
===================================

This contains a development and system administration guide for the Fedora
Infrastructure team.

The development guide covers how to get started with application development
as well as application best practices. You will also find several sample
projects that serve as demonstrations of these best practices and as an
excellent starting point for new projects.

The system administration guide covers how to get involved in the system
administration side of Fedora Infrastructure as well as the standard operating
procedures (SOPs) we use.

The source repository for this documentation is maintained here:
https://pagure.io/infra-docs


.. _getting-started:

Getting Started
===============

Fedora Infrastructure is full of projects that need help. In fact, there is so
much work to do, it can be a little overwhelming. This document is intended to
help you get ready to contribute to the Fedora Infrastructure.


Create a Fedora Account
-----------------------

The first thing you should do is create a `Fedora account`_. Your Fedora
account will be used for nearly everything you do as a member of the Fedora
community.

Once you've created your Fedora account, you need to read and sign the
`Fedora Project Contributor Agreement`_ (FPCA).


Subscribe to the Mailing List
-----------------------------

Next, you should join the `Fedora Infrastructure mailing list`_. You will need
to log into your new Fedora account to subscribe. The mailing list is the
best way to have a discussion with the entire Fedora Infrastructure community.


Join IRC
--------

Join us on `Internet Relay Chat`_ (IRC) to chat in real time. For a more
thorough introduction to IRC, check out the Fedora Magazine's `beginner's
guide to IRC`_. There are many Fedora IRC channels on `freenode`_. To start
with, you should check out the ``#fedora-admin`` and ``#fedora-apps`` channels.
These channels are for Fedora Infrastructure system administration and application
development, respectively.


Next Steps
----------

Congratulations, you are now ready to get involved in a project! If application
development is what you're interested in, check out our developer
:ref:`dev-getting-started` guide.

If system administration sounds more to your liking, see the system administrator
:ref:`sysadmin-getting-started` guide.


Full Table of Contents
======================

.. toctree::
   :maxdepth: 2
   :caption: Full Table of Contents:

   dev-guide/index
   sysadmin-guide/index
   sysadmin-guide/sops/old/index


Indices and tables
==================

* :ref:`genindex`
* :ref:`search`


.. _Fedora account:
    https://admin.fedoraproject.org/accounts/
.. _Fedora Project Contributor Agreement:
    http://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement
.. _Fedora Infrastructure mailing list:
    https://lists.fedoraproject.org/admin/lists/infrastructure.lists.fedoraproject.org/
.. _Internet Relay Chat:
    https://en.wikipedia.org/wiki/Internet_Relay_Chat
.. _beginner's guide to IRC:
    https://fedoramagazine.org/beginners-guide-irc/
.. _freenode:
    https://freenode.net/