https://github.com/phpspec/phpspec-docs
PHPSpec Documentation
https://github.com/phpspec/phpspec-docs
Last synced: about 1 year ago
JSON representation
PHPSpec Documentation
- Host: GitHub
- URL: https://github.com/phpspec/phpspec-docs
- Owner: phpspec
- Created: 2012-01-01T14:53:14.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2012-02-25T06:37:59.000Z (over 14 years ago)
- Last Synced: 2025-03-26T09:51:16.287Z (over 1 year ago)
- Language: Python
- Homepage: http://www.phpspec.net/documentation
- Size: 171 KB
- Stars: 18
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README
Awesome Lists containing this project
README
Contributing to documentation
=============================
Intro
-----
It is good everyone contributes with documentation.
We use sphinx and some custom styling to have offline/online documentation and automate things so that anyone can easily write rst format which is almost like markdown to write up documentation for just about anything.
``rst`` extension stands for restructured format. This short page is written in ``rst`` for your example.
Setting things up
-----------------
I follow the instructions from this `link `_.
Which basically tells us to install with the following command:
``$ sudo easy_install -U Sphinx``
How to contribute
-----------------
To clone the doc repos do:
.. code-block:: bash
$ git clone github.com/phpspec/phpspec-docs.git
Do your changes, commit, and push to your own fork on github, then send a PR to the main repo.
How to compile
--------------
To test or have an off line version of documentation you will just run:
.. code-block:: bash
$ make html
Make sure your syntax is correct by following the error messages if any.
The idea is that everything needs to get documented properly as it is very easy to write rst on the fly.
That is it! PHPSpec FTW!