Skip to content

Commit

Permalink
Merge pull request #54 from ConorMacBride/documentation-updates
Browse files Browse the repository at this point in the history
Update documentation
  • Loading branch information
ConorMacBride authored Mar 17, 2023
2 parents f254317 + 6b67291 commit 8f2a3df
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 20 deletions.
7 changes: 0 additions & 7 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -88,8 +88,6 @@ Getting Started

Documentation is `available here <https://mcalf.macbride.me/>`_.
Some examples are included `here <examples/>`_.
If you are interested in using this package in your research and would
like advice on how to use this package, please contact `Conor MacBride`_.

Contributing
------------
Expand All @@ -103,11 +101,8 @@ Types of ways you can contribute include, expanding the documentation with
more use cases and examples, reporting bugs through the GitHub issue tracker,
reviewing pull requests and the existing code, fixing bugs and implementing new
features in the code.

You are encouraged to submit any `bug reports`_ and `pull requests`_ directly
to the `GitHub repository`_.
If you have any questions regarding contributing to this package please
contact `Conor MacBride`_.

Please note that this project is released with a Contributor Code of Conduct.
By participating in this project you agree to abide by its terms.
Expand Down Expand Up @@ -168,8 +163,6 @@ MCALF is licensed under the terms of the BSD 2-Clause license.
.. _new conda environment: https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html
.. _documentation: https://mcalf.macbride.me/en/latest/guide/index.html#testing

.. _Conor MacBride: https://macbride.me/

.. _bug reports: https://github.com/ConorMacBride/mcalf/issues
.. _pull requests: https://github.com/ConorMacBride/mcalf/pulls
.. _GitHub repository: https://github.com/ConorMacBride/mcalf
Expand Down
16 changes: 3 additions & 13 deletions docs/guide/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ Using MCALF with pip
====================

To run the tests you need a number of extra packages installed. If you
installed MCALF using pip, you can run ``pip install mcalf[tests]`` to
installed MCALF using pip, you can run ``pip install "mcalf[tests]"`` to
install the additional testing dependencies (and MCALF if it's not
already installed).

Expand All @@ -104,7 +104,7 @@ testing dependencies using the following command.

.. code:: bash
$ conda install pytest pytest-cov tox
$ conda install pytest pytest-cov pytest-mpl tox
Running Tests
~~~~~~~~~~~~~
Expand All @@ -131,7 +131,7 @@ is available in their `documentation`_. You can mostly replace

.. code:: bash
$ pip install -e .[tests,docs]
$ pip install -e ".[tests,docs]"
After making changes to the MCALF source, run the MCALF test suite with
the following command (while in the same directory as ``setup.py``),
Expand All @@ -148,18 +148,13 @@ Getting Started
The following examples provide the key details on how to use this package.
For more details on how to use the particular classes and function,
please consult the `Code Reference <../code_ref/index.html>`_.
We plan to expand this section with more examples of this package being
used.

.. toctree::

../gallery/index
examples/example1/index
examples/neural_network/LabellingTutorial

If you are interested in using this package in your research and would
like advice on how to use this package, please contact `Conor MacBride`_.

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

Expand All @@ -172,11 +167,8 @@ Types of ways you can contribute include, expanding the documentation with
more use cases and examples, reporting bugs through the GitHub issue tracker,
reviewing pull requests and the existing code, fixing bugs and implementing new
features in the code.

You are encouraged to submit any `bug reports`_ and `pull requests`_ directly
to the `GitHub repository`_.
If you have any questions regarding contributing to this package please
contact `Conor MacBride`_.

Please note that this project is released with a Contributor Code of Conduct.
By participating in this project you agree to abide by its terms.
Expand Down Expand Up @@ -238,8 +230,6 @@ MCALF is licensed under the terms of the BSD 2-Clause license.
.. _setup.cfg: https://github.com/ConorMacBride/mcalf/blob/main/setup.cfg
.. _documentation: https://docs.sunpy.org/en/latest/dev_guide/contents/newcomers.html#setting-up-a-development-environment

.. _Conor MacBride: https://macbride.me/

.. _bug reports: https://github.com/ConorMacBride/mcalf/issues
.. _pull requests: https://github.com/ConorMacBride/mcalf/pulls
.. _GitHub repository: https://github.com/ConorMacBride/mcalf
Expand Down

0 comments on commit 8f2a3df

Please # to comment.