X-Git-Url: https://adrianiainlam.tk/git/?a=blobdiff_plain;ds=inline;f=docs%2Fchanges.html;h=6ee730015cda02f0cbc1b1c7dcfd6428d1521e32;hb=f18fd5457683812b3136a2e7de2329a62e542a1a;hp=b7a79712e45ea419ddc2c4fad5a38d960dbdc6ec;hpb=e14b35042fcba0a67878e0bafe8d4f85c82116c5;p=dygraphs.git
diff --git a/docs/changes.html b/docs/changes.html
index b7a7971..6ee7300 100644
--- a/docs/changes.html
+++ b/docs/changes.html
@@ -2,10 +2,21 @@
- dygraphs input types
+ Guide to making dygraphs changes
@@ -14,8 +25,49 @@
Guide to making dygraphs changes
So you've made a change to dygraphs and would like to contribute it back
- to the open source project. Wonderful! This is a step-by-step guide
- explaining how to do it.
+ to the open source project. Wonderful!
+
+ This is a step-by-step guide explaining how to do it.
+
+ dygraphs style
+ First of all, please try to follow the style of the existing dygraphs
+ code. This will make the review process go much more smoothly.
+
+
A few salient points:
+
+ - I try to adhere to Google's
+ JS style guide and would appreciate it if you try to as well. This
+ means:
+
+ - No tabs! Indent using two spaces.
+
- Use camelCase for variable and function names.
+
- Limit lines to 80 characters.
+
+
+ - Please run 'lint.sh' to see if you've introduced any new violations.
+
+
- If you've added a new feature, add a test for it (in the tests/
+ directory) or a gallery entry.
+
+
- If you've added an option, document it in
+ dygraph-options-reference.js. You'll get lots of warnings if you don't.
+
+
- If you've fixed a bug or added a feature, add an auto_test for
+ it.
+ This ensures that we won't inadvertently break your feature in the
+ future. To do this, either add to an existing auto_test in
+ auto_tests/tests or run "auto_tests/misc/new-test.sh your-test-name" to
+ create a new one. You can run your auto_test in any browser by visiting
+ auto_tests/misc/local.html.
+
+
+ Sending a Pull Request
+
+ dygraphs is hosted on github, which uses a "pull request" model. They
+ have a good writeup here. These
+ instructions discuss dygraphs more specifically.
The list of steps may look a bit daunting, but it's not too bad,
especially if you have any familiarity with git or github. If you run into
@@ -45,17 +97,9 @@
cd into the dygraphs directory and make your changes.
If you've already got them somewhere else, just copy them over.
- I try to adhere to Google's
- JS style guide and would appreciate it if you try to as well.
-
- Be a good citizen!
-
- - If you've added a new feature, add a test for it (in the tests/
- directory).
-
- If you've added a new option, add it to the list of options on the
- documentation page (docs/index.html).
-
+
+ Be a good citizen! Make sure your code follows the guidelines
+ above.
You'll have to do this before I accept your changes, so you may as well
do it now
@@ -81,5 +125,17 @@ git commit
Once your change is ready, I'll pull it into the main dygraphs
repository and publish it to the web.
+
+
+