Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added batch for read the docs and fixed README.rst #6

Merged
merged 7 commits into from
May 9, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 7 additions & 13 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ FermiLib - An open source software for analyzing quantum simulation algorithms
.. image:: https://coveralls.io/repos/github/ProjectQ-Framework/FermiLib/badge.svg
:target: https://coveralls.io/github/ProjectQ-Framework/FermiLib

.. image:: https://readthedocs.org/projects/fermilib/badge/?version=latest
:target: http://fermilib.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status


FermiLib is an open source effort for analyzing quantum simulation algorithms.

Expand All @@ -16,7 +20,7 @@ Getting started
---------------

To start using FermiLib, simply follow the installation instructions in the `intro <https://github.com/ProjectQ-Framework/FermiLib/tree/master/docs/intro.html>`__. There, you will also find `code examples <https://github.com/ProjectQ-Framework/FermiLib/tree/master/examples.html>`__. Also, make sure to check out the `ProjectQ
website <http://www.projectq.ch>`__ and the detailed `code documentation <https://github.com/ProjectQ-Framework/FermiLib/tree/master/docs/>`__.
website <http://www.projectq.ch>`__ and the detailed `code documentation <https://fermilib.readthedocs.io/>`__.

How to contribute
-----------------
Expand All @@ -26,8 +30,8 @@ To contribute code please adhere to the following very simple rules:
1. Make sure your new code comes with extensive tests!
2. Make sure you adhere to our style guide. Until we release a code style
guide, just have a look at our code for clues. We mostly follow pep8 and use the pep8 linter to check for it.
3. Put global constants and configuration parameters into src/config.py, and
add 'from config import *' in the file that uses the constants/parameters.
3. Put global constants and configuration parameters into src/fermilib/config.py, and
add *from config import ** in the file that uses the constants/parameters.

Documentation can be found `here <https://github.com/ProjectQ-Framework/FermiLib/tree/master/docs/>`_.

Expand All @@ -41,13 +45,3 @@ License
-------

FermiLib is released under the Apache 2 license.










4 changes: 2 additions & 2 deletions docs/intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 +13,14 @@ Installing FermiLib requires pip. Make sure that you are using an up-to-date ver

.. code-block:: bash

python -m pip install --user fermilib
python -m pip install --pre --user fermilib

Alternatively, clone/download `this repo <https://github.com/ProjectQ-Framework/FermiLib>`_ (e.g., to your /home directory) and run

.. code-block:: bash

cd /home/fermilib
python -m pip install --user .
python -m pip install --pre --user .

This will install FermiLib and all its dependencies automatically. In particular, FermiLib requires `ProjectQ <https://projectq.ch>`_ . It might be useful to install ProjectQ separately before installing FermiLib as it might require setting some manual options such as, e.g., a C++ compiler. Please follow the `ProjectQ installation <https://projectq.ch/code-and-docs/>`_ instructions. FermiLib is compatible with both Python 2 and 3.

Expand Down