Skip to content

Latest commit

 

History

History
48 lines (32 loc) · 1.5 KB

CONTRIBUTING.md

File metadata and controls

48 lines (32 loc) · 1.5 KB

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/fireball-x/firedoc.git
$ cd firedoc
$ 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 that we ask contributors to electronically sign before merging in their Pull Requests.