src/cm/media/js/lib/yui/yui3-3.15.0/README.md
changeset 602 e16a97fb364a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui3-3.15.0/README.md	Mon Mar 10 15:19:48 2014 +0100
@@ -0,0 +1,129 @@
+YUI 3: The Yahoo User Interface Library
+=======================================
+
+[![Build Status](https://secure.travis-ci.org/yui/yui3.png?branch=master)](http://travis-ci.org/yui/yui3)
+
+YUI is a free, open source JavaScript and CSS framework for building richly
+interactive web applications. YUI is provided under a BSD license and is
+available on GitHub for forking and contribution.
+
+Links
+-----
+
+  * [Home Page](http://yuilibrary.com/)
+  * [Documentation](http://yuilibrary.com/yui/docs/)
+  * [Blog](http://yuiblog.com)
+  * [Latest Production Release](http://yuilibrary.com/download/yui3/)
+  * [Forums](https://groups.google.com/forum/#!forum/yui-support)
+  * [License](http://yuilibrary.com/license/)
+  * [Contributor Info](https://github.com/yui/yui3/blob/master/CONTRIBUTING.md)
+  * [Contributor Mailing List](https://groups.google.com/forum/?fromgroups#!forum/yui-contrib)
+  * [Report a Bug](http://yuilibrary.com/yui/docs/tutorials/report-bugs/)
+  * [Shifter, for building YUI](http://yui.github.com/shifter/)
+
+
+Source Info
+-----------
+
+This is the active working source tree for YUI 3. It contains work in progress
+toward the next YUI 3 releases and may be unstable.
+
+We encourage you to use the latest source for evaluation purposes, testing new
+features and bug fixes, and to provide feedback on new functionality. Please
+refer to the "Latest Production Release" link above if you're looking for the
+latest stable release of YUI recommended for production use.
+
+If you plan on contributing to YUI, please join and monitor the "Contributor
+Mailing List" listed above. Information about milestones and tree closures
+will be made available there.
+
+
+## Branch Information
+
+YUI's development happens on five main branches. The following describes what
+each of these code branches represents:
+
+  * `live-docs`: Represents the latest GA release of YUI, plus any
+    documentation-only updates. Any tweaks or additions to the docs for the
+    latest release happen on this branch, and they are reflected on the website.
+
+  * `master`: (Read-only) Contains everything in `live-docs`, plus code changes that will go
+    into the next YUI release. The code changes in `master` are either bug fixes
+    or small changes which should not break API compatibility. Patch releases
+    will be cut from this branch; e.g. 3.6.x. *All code in this branch has fully
+    passed all unit tests and should be stable.*
+
+  * `3.x`: (Read-only) Represents the next major YUI release; e.g. 3.7.0. This is an
+    integration branch which contains everything in `master`, plus larger code
+    changes which will go into a future YUI release. The changes in `3.x`
+    require a minor version increment before they are part of release, e.g.,
+    3.7.0. Preview Releases will be cut from this branch for developers to test
+    and evaluate. *All code in this branch has fully passed all unit tests and should be stable.*
+
+  * `dev-master` and `dev-3.x`: Current working branches containing code that
+    **has not** been through the CI process. **Developers check their changes in to
+    these integration branches for the automated testing system to validate.** Once they
+    are validated, the code is merged into `master` and `3.x` respectively. **Never** check in to
+    `master` or `3.x` directly.
+
+  * `release-3.x.x`: Short-lived release branches where code checkins are carefully
+    managed for extensive testing and release deployment.
+
+## Source Tree
+
+The YUI source tree includes the following directories:
+
+  * `build`: Built YUI source files. The built files are generated at
+    development time from the contents of the `src` directory. The build step
+    generates debug files (unminified and with full comments and logging),
+    raw files (unminified, but without debug logging), and minified files
+    (suitable for production deployment and use).
+
+  * `src` Raw unbuilt source code (JavaScript, CSS, image assets, ActionScript
+     files, etc.) for the library. Beginning with YUI 3.4.0, the `src` directory
+     also contains all module-specific documentation, tests and examples. All
+     modifications to the library and its documentation should take place in
+     this directory.
+
+## Initial Setup
+
+   1. Fork the project on GitHub (http://www.github.com/yui/yui3).
+   1. Clone the fork to your local environment for development.
+
+## Do Good Stuff
+
+   1. Create a feature branch to house atomic code changes.
+   `git checkout -b myfeature upstream/master --no-track`
+   1. Satisfy the contribution requirements
+   (see [YUI Contribution Standards](https://github.com/yui/yui3/wiki/Contribution-Standards)).
+   1. Push changes to your fork.
+   1. Submit a pull request from your fork to the `live-docs`,
+   `dev-master`, or `dev-3.x` branch  for review.
+   1. Incorporate community feedback.
+   1. Push changes to your fork -- the pull request will automatically update.
+   1. Rinse and repeat.
+
+All changes should continue to be made on the feature branch; that way the pull
+request you submit will automatically update to include them. Make sure to keep
+the feature branch updated with the latest changes from master, so that they
+don't diverge during your development process.
+
+## Important Tips
+
+  * Always work from a feature branch. Since all code submissions will be
+  through a Pull Request, feature branches isolate changes from one submission to another.
+  * Always start your new branch from the branch you want to submit to:
+  `git checkout -b myfeature dev-master`
+  * Remember to submit your Pull Request to the proper `dev-` branch and not
+  `master` or `3.x`.
+
+## Building
+
+To build YUI components install [Shifter](http://yui.github.com/shifter/) (`npm -g install shifter`)
+and then simply run `shifter` in that components directory.
+
+Shifter also allows you to rebuild the entire YUI src tree:
+
+    cd yui3/src && shifter --walk
+
+