Skip to content

Commit

Permalink
feat: add a small note on powershell docs setup to CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
NimmiW authored and janl committed Feb 27, 2017
1 parent 00a8e28 commit 62fe627
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions docs/developers/CONTRIBUTING_DOCS.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,22 @@ Then install two pip packages: `Sphinx <http://www.sphinx-doc.org/en/stable/>`_
Change directory to ..hoodie/docs/

``make html``
|
If you are using windows powershell, note there is a little deviation.

``pip install sphinx``

``pip install sphinx_rtd_theme``

Before execute the ``make html`` command you have to install `make <http://gnuwin32.sourceforge.net/packages/make.htm>`_ in windows if you are not already done.
You can also see this Stackoverflow `link <http://stackoverflow.com/questions/12881854/how-to-use-gnu-make-on-windows>`_ for a clear understanding.

Now change directory to ..hoodie/docs/

``make html``

|
After building, your updated documents are in the docs/_build/html subdirectory. Click on any .html document, this will open your web browser and the documents will be viewable.

Expand Down

1 comment on commit 62fe627

@gr2m
Copy link
Member

@gr2m gr2m commented on 62fe627 Feb 27, 2017

Choose a reason for hiding this comment

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

@janl no biggie, just fyi: docs get generated on every commit in master, it’s independent of semantic-release. We can use the docs: prefix and the docs get updated anyway (there is a bug there right now though, someone is looking into it). That way we don’t release a new version of hoodie without any code changes

Please sign in to comment.