From 7180c032477a66b1b2ce21fc2477fe345a6fe98a Mon Sep 17 00:00:00 2001 From: Gregg Tavares Date: Sat, 29 Dec 2012 01:02:58 +0900 Subject: [PATCH 1/2] add some guidelines adding tests --- README.md | 3 ++ sdk/tests/README.md | 3 ++ sdk/tests/test-guidelines.md | 53 ++++++++++++++++++++++++++++++++++++ 3 files changed, 59 insertions(+) create mode 100644 sdk/tests/test-guidelines.md diff --git a/README.md b/README.md index 9ed2707c2c..33991228b2 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,9 @@ This is the offical home of the Khronos WebGL repository for the WebGL specifications and the WebGL conformance test suite. +Before adding a new test or editing an existing test +. + You can find live versions of the specifications at http://www.khronos.org/webgl/ diff --git a/sdk/tests/README.md b/sdk/tests/README.md index fdf8a539c6..8c3a8c2271 100644 --- a/sdk/tests/README.md +++ b/sdk/tests/README.md @@ -1,6 +1,9 @@ Welcome to the WebGL Conformance Test Suite =========================================== +Note: Before adding a new test or editing an existing test +. + This is the initial release of the WebGL conformance test suite. NOTE TO USERS: Unless you are a WebGL implementor, there is no need to submit diff --git a/sdk/tests/test-guidelines.md b/sdk/tests/test-guidelines.md new file mode 100644 index 0000000000..d778e7c9b5 --- /dev/null +++ b/sdk/tests/test-guidelines.md @@ -0,0 +1,53 @@ +Contributing WebGL conformance tests Guidelines +=============================================== + +Thank you for contibuting to the WebGL conformance tests. +Please try to follow these guidelines when submitting a test + +1) All changes and/or new tests should go in the sdk/tests/conformance folder + +The tests under conformance-suites are snapshots and are only to be updated by +the WebGL Working Group when "official" snapshots are taken. + +2) Please use the Khronos Group License (MIT) + +This lines appears at the top of every html and js file under sdk/tests/conformance + + + +3) Please use code similar to the code in existing tests + +Ideally, copy an existing test and modify it for your new test. Try not to duplicate +code that already exists where approriate. + +4) If adding a new test edit the approriate 00_test_list.txt file + +Each folder has a 00_test_list.txt file that lists the test in that folder. +Each new test should be prefixed with the option "--min-version " where +version is 1 more than the newest official verison. At the time of this writing +all new tests should be prefixed with "--min-version 1.0.2" + + From 0e5a37466591a15071f1f48b59eaf4e152ab8007 Mon Sep 17 00:00:00 2001 From: Gregg Tavares Date: Sat, 29 Dec 2012 01:09:44 +0900 Subject: [PATCH 2/2] fix typos --- README.md | 2 +- sdk/tests/README.md | 2 +- sdk/tests/test-guidelines.md | 12 ++++++------ 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 33991228b2..0453b57c49 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ WebGL repository for the WebGL specifications and the WebGL conformance test suite. Before adding a new test or editing an existing test -. + please read these guidelines. You can find live versions of the specifications at http://www.khronos.org/webgl/ diff --git a/sdk/tests/README.md b/sdk/tests/README.md index 8c3a8c2271..79025bb4ce 100644 --- a/sdk/tests/README.md +++ b/sdk/tests/README.md @@ -2,7 +2,7 @@ Welcome to the WebGL Conformance Test Suite =========================================== Note: Before adding a new test or editing an existing test -. + please read these guidelines. This is the initial release of the WebGL conformance test suite. diff --git a/sdk/tests/test-guidelines.md b/sdk/tests/test-guidelines.md index d778e7c9b5..ed8a32fbec 100644 --- a/sdk/tests/test-guidelines.md +++ b/sdk/tests/test-guidelines.md @@ -2,16 +2,16 @@ Contributing WebGL conformance tests Guidelines =============================================== Thank you for contibuting to the WebGL conformance tests. -Please try to follow these guidelines when submitting a test +Please try to follow these guidelines when submitting a test. -1) All changes and/or new tests should go in the sdk/tests/conformance folder +* All changes and/or new tests should go in the sdk/tests/conformance folder The tests under conformance-suites are snapshots and are only to be updated by the WebGL Working Group when "official" snapshots are taken. -2) Please use the Khronos Group License (MIT) +* Please use the Khronos Group License (MIT) -This lines appears at the top of every html and js file under sdk/tests/conformance +These lines appears at the top of every html and js file under sdk/tests/conformance -3) Please use code similar to the code in existing tests +* Please use code similar to the code in existing tests Ideally, copy an existing test and modify it for your new test. Try not to duplicate code that already exists where approriate. -4) If adding a new test edit the approriate 00_test_list.txt file +* If adding a new test edit the approriate 00_test_list.txt file Each folder has a 00_test_list.txt file that lists the test in that folder. Each new test should be prefixed with the option "--min-version " where