Thanks to visit codestin.com
Credit goes to github.com

Skip to content

updating developer docs #8544

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.

Sign up for GitHub

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

Merged
merged 8 commits into from
Apr 28, 2017
Merged

updating developer docs #8544

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
83129fa
updating developer docs
choldgraf Apr 27, 2017
0baccc7
addressing comments
choldgraf Apr 28, 2017
530c62d
Update documenting_mpl.rst
choldgraf Apr 28, 2017
23f4757
Update documenting_mpl.rst
choldgraf Apr 28, 2017
5efe61c
Update documenting_mpl.rst
choldgraf Apr 28, 2017
ff1b20e
Update documenting_mpl.rst
choldgraf Apr 28, 2017
c6866a0
Update documenting_mpl.rst
choldgraf Apr 28, 2017
d73ff15
fixing link
choldgraf Apr 28, 2017
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
Prev Previous commit
Next Next commit
Update documenting_mpl.rst
  • Loading branch information
@choldgraf
choldgraf authored Apr 28, 2017
commit 5efe61cd8108ffdd0f2df1056d5eb53d1edd1bea
6 changes: 3 additions & 3 deletions doc/devel/documenting_mpl.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,17 +34,17 @@ General structure
-----------------

All documentation is built from the :file:`doc/` directory. This directory contains both
``.rst`` files that contain pages in the documentation, directory that contain more
``.rst`` files that contain pages in the documentation, directories that contain more
``.rst`` files, and configuration files for Sphinx.

.. note::

An exception to this are the directories :file:`gallery` and :file:`tutorials`, which
exist in the root directory. These contain Python files that are built by ``sphinx-gallery``.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s-g should be be a link instead of double-quoted, similarly to Sphinx_ (note the underscore) at the top. The link targets are listed a bit in the middle of nowhere (just before the Figure section), may be worth moving them to the top or the bottom or the file (or just use inline link format like for graphviz above).

When the docs are built, directory of the same name will be generated inside of :file:`docs/`.
When the docs are built, directories of the same name will be generated inside of :file:`docs/`.
The generated directories :file:`docs/gallery` and :file:`docs/tutorials` can be safely deleted.

The configuration file for Sphinx is :file:`doc/conf.py`. It controls which directory
The configuration file for Sphinx is :file:`doc/conf.py`. It controls which directories
Sphinx parses, how the docs are built, and how the extensions are used.

Building the docs
Expand Down