The source code that powers readthedocs.org
 
 
 
 
 
 
Go to file
Eric Holscher 3340364802
Merge pull request #5486 from rtfd/release/3.4.0
Release 3.4.0
2019-03-18 17:08:50 -03:00
.github Do not allow to merge 'Status: blocked' PRs 2019-01-31 10:28:54 +01:00
.tx added tx config 2012-10-03 13:28:54 +02:00
common@ac9eafa1e5 Update common submodule 2019-02-19 20:56:51 +01:00
contrib Call Celery worker properly 2018-11-08 20:46:43 +01:00
docs Promote the YAML config 2019-03-18 12:37:39 -07:00
logs Put the logs directory in the repo. 2012-03-12 15:35:28 -07:00
media #4036 Updated build list to include an alert state (#5222) 2019-02-20 14:03:21 -07:00
readthedocs Promote the YAML config 2019-03-18 12:37:39 -07:00
requirements Enable Django Debug Toolbar in development 2019-03-15 10:27:35 -07:00
scripts/travis Merge remote-tracking branch 'origin/master' into search-reapply 2019-01-22 13:59:47 -05:00
.codecov.yml Disable diff coverage status 2019-02-27 11:41:59 -05:00
.coveragerc Ignore six.PY2 from coverage 2018-12-04 15:59:26 -05:00
.eslintrc Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.flake8 Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.gitattributes Fix woff2 files (#4049) 2018-05-03 16:09:08 -06:00
.gitignore gitignore dev.db-journal file #5463 2019-03-15 23:57:01 +06:00
.gitmodules Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.isort.cfg Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.pep8 Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.pre-commit-config.yaml Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.pyup.yml pyup.yml syntax fixed 2019-02-13 13:54:58 +01:00
.readthedocs.yml Fix docs build 2019-01-23 17:04:25 -05:00
.style.yapf Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
.travis.yml Use Ubuntu xenial on travis 2019-03-13 19:32:38 -05:00
AUTHORS.rst Link to the documentation page for the core team 2018-02-16 09:26:18 -05:00
CHANGELOG.rst Release 3.4.0 2019-03-18 16:43:42 -03:00
LICENSE Update LICENSE 2019-01-17 15:30:40 +03:00
MANIFEST.in Adjust manifest 2017-09-07 18:59:19 -04:00
README.rst Update README.rst 2019-01-16 09:40:46 +01:00
bower.json Revert "Upgrade theme media to 0.4.2" 2018-10-06 19:59:28 +02:00
conftest.py Indentation fixed 2019-02-27 00:03:21 +06:00
gulpfile.js Updates for the manifest storage 2018-07-25 12:21:47 -07:00
manage.py Settings and public domain restructure (#1829) 2016-04-14 14:58:28 -07:00
package.json Track actual ad views 2018-11-09 13:28:59 -08:00
prospector-more.yml Cleaned up remaining code 2018-02-24 01:27:08 +05:30
prospector.yml Drop readthedocs- prefix to submodule (#3916) 2018-04-05 22:00:58 -06:00
pytest.ini Ignore warnings on pytest summary 2018-12-04 12:21:31 +01:00
requirements.txt Added top-level requirements file 2015-04-15 11:37:12 -07:00
setup.cfg Release 3.4.0 2019-03-18 16:43:42 -03:00
setup.py Add changelog and changelog automation (#3364) 2017-12-07 11:03:00 -07:00
tasks.py Declare and improve invoke tasks 2019-01-07 10:13:32 +01:00
tox.ini Do not run py27 on tox 2019-01-03 16:42:58 +01:00

README.rst

Welcome to Read the Docs
========================

|build-status| |docs| |coverage|

Purpose
-------

`Read the Docs`_ hosts documentation for the open source community. It supports
Sphinx_ docs written with reStructuredText_, and can pull from your Subversion_,
Bazaar_, Git_, and Mercurial_ repositories.
Then we build documentation and host it for you.
Think of it as *Continuous Documentation*.

.. _Read the docs: http://readthedocs.org/
.. _Sphinx: http://www.sphinx-doc.org/
.. _reStructuredText: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
.. _Subversion: http://subversion.tigris.org/
.. _Bazaar: http://bazaar.canonical.com/
.. _Git: http://git-scm.com/
.. _Mercurial: https://www.mercurial-scm.org/

Documentation for RTD
---------------------

You will find complete documentation for setting up your project at `the Read
the Docs site`_.

.. _the Read the Docs site: https://docs.readthedocs.io/

Get in touch
------------

You can find information about getting in touch with Read the Docs at our `Contribution page <https://docs.readthedocs.io/en/latest/contribute.html#get-in-touch>`_.

Contributing
------------

You can find information about contributing to Read the Docs at our `Contribution page <http://docs.readthedocs.io/en/latest/contribute.html>`_.

Quickstart for GitHub-Hosted Projects
-------------------------------------

By the end of this quickstart, you will have a new project automatically updated
when you push to GitHub.

#. Create an account on `Read the Docs`_.  You will get an email verifying your
   email address which you should accept within 7 days.

#. Log in and click on "Import a Project".

#. Click "Connect to GitHub" in order to connect your account's repositories to GitHub.

#. When prompted on GitHub, give access to your account.

#. Click "Import a Repository" and select any desired repository.

#. Change any information if desired and click "Next".

#. All done.  Commit away and your project will auto-update.


.. |build-status| image:: https://img.shields.io/travis/rtfd/readthedocs.org.svg?style=flat
    :alt: build status
    :scale: 100%
    :target: https://travis-ci.org/rtfd/readthedocs.org

.. |docs| image:: https://readthedocs.org/projects/docs/badge/?version=latest
    :alt: Documentation Status
    :scale: 100%
    :target: https://docs.readthedocs.io/en/latest/?badge=latest

.. |coverage| image:: https://codecov.io/gh/rtfd/readthedocs.org/branch/master/graph/badge.svg
    :alt: Test coverage
    :scale: 100%
    :target: https://codecov.io/gh/rtfd/readthedocs.org

License
-------

`MIT`_ © 2010-2019 Read the Docs, Inc & contributors

.. _MIT: LICENSE