Skip to content

Commit

Permalink
Merge pull request #283 from okuryu/contributing
Browse files Browse the repository at this point in the history
Move from DEVELOPMENT.md to CONTRIBUTING.md
  • Loading branch information
okuryu committed Nov 21, 2014
2 parents 0de8440 + df2c592 commit 5d7fe86
Show file tree
Hide file tree
Showing 3 changed files with 53 additions and 29 deletions.
48 changes: 48 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
Contributing to YUIDoc
======================

Getting Involved
----------------

If you want to work on the default theme or need to work on the libraries, here's the steps:

$ git clone git://github.com/yui/yuidoc.git
$ cd yuidoc
$ npm link

This will link `yuidoc` into the global folder. This basically installs it globally as a
link to this source directory.

Now all changes you make to the current source tree are available in the global `yuidoc`
executable. No need to reinstall the app to test your changes.

Running Unit Tests
------------------

You are also able to run unit tests by executing `npm test`.

$ npm test

Server Mode
-----------

For performance, the Handlebars templates are cached from the first request. So you will have
to terminate the server and relaunch it before you can see your changes.

Assets should not be cached, so they should still serve new files on each request. This way
you can modify the JavaScript and CSS files on the fly.

Submitting Pull Requests
------------------------

Pull Requests are very welcome, but should be within the scope of the project, and follow the
repository's code conventions. Before submitting a Pull Request, it's always good to file an
issue, so we can discuss the details of the Pull Request.

The Yahoo CLA
-------------

At Yahoo, we have a single [Yahoo Open Source Contributor License Agreement][CLA] that we ask
contributors to electronically sign before merging in their Pull Requests.

[CLA]: https://yahoocla.herokuapp.com/
29 changes: 0 additions & 29 deletions DEVELOPMENT.md

This file was deleted.

5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,11 @@ Documentation
* [API Docs](http://yui.github.io/yuidoc/api/)
* [Mailing List](https://groups.google.com/forum/#!forum/yuidoc)

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

Please see the [CONTRIBUTING.md](CONTRIBUTING.md).

License
-------

Expand Down

0 comments on commit 5d7fe86

Please sign in to comment.