Moving Testing Expectation from Dynamo Wiki to Dynamo Primer

11_developer_primer/6_testing-expectations/1-testing-expectations.md

@@ -0,0 +1,47 @@
+# Testing expectations
+
+This page describes what we're looking for with testing on new code being added to Dynamo.
+
+So. You've got a new node that you want to add. Awesome. It's time to add some tests. There are two reasons to do this.
+
+1. It helps to find out where it doesn't work
+2. When someone else changes something that breaks your node, it should break the tests. That way that person who broke the tests needs to go and fix it. If it doesn't break the tests, then it's largely your problem to deal with the users' whose models get broken.
+
+Testing in Dynamo comes in two broad types: Unit Tests, System Tests.
+
+## Unit Tests
+
+Unit tests should test as little as possible. If you built a node that computes square roots via a C# zero touch node, the test should test only that DLL and make C# calls directly to that code. The unit tests shouldn't even include Dynamo.
+
+It should include:
+
+* Positive tests (it does the right thing)
+* Negative tests (it doesn't barf when given garbage input)
+* Regression tests (when someone finds a bug in your code, write a test to ensure that it doesn't reoccur)
+
+They should be small, fast and reliable. The majority of tests should be unit tests.
+
+## System Tests
+
+System tests operate on multiple components and test how they fit together. They should be used and crafted carefully. 
+
+Why? They're expensive to run. We need to keep the test suite running with as little latency as possible.
+
+When writing a system test, the first thing to do is to look at [this](https://github.com/DynamoDS/Dynamo/blob/master/doc/system/Layer%20Diagram.pdf) diagram and work out which sub-systems you're covering.
+
+Ideally, there would be a progressive series of tests covering increasing sets of the interacting blocks so when the tests start failing it's very quick to find out where the problem is.
+
+Examples of things that need System Tests:
+
+* A new type of Revit node that stores multiple elements in trace rather than a single element
+* A new watch node that displays data differently
+
+Example of things that don't need System Tests:
+
+* A new math node
+* A string processing library
+
+System tests should:
+
+* Assert the correct behaviour
+* Assert an absence of pathological behaviours, e.g. no exceptions

SUMMARY.md

@@ -125,8 +125,9 @@
   * [Publish a Package](11\_developer\_primer/4\_publish\_a\_package/README.md)
     * [Build a Package from Visual Studio](11\_developer\_primer/4\_publish\_a\_package/1-build-a-package-from-visual-studio.md)
     * [Extensions as Packages](11\_developer\_primer/4\_publish\_a\_package/2-extensions-as-packages.md)
-  * [Pull Requests](11\_developer\_primer/pull-requests.md)
-  * [Examples](11\_developer\_primer/5\_examples/README.md)
+  * [Pull Requests](11\_developer\_primer/5\_pull\_requests/1-pull-requests.md)
+  * [Testing Expectations](11\_developer\_primer/6\_testing\_expectations/1-testing-expectations.md)
+  * [Examples](11\_developer\_primer/7\_examples/README.md)
 * [Appendix](a\_appendix/README.md)
   * [Visual Programming and Dynamo](a\_appendix/a-1\_visual-programming-and-dynamo.md)
   * [Resources](a\_appendix/a-2\_resources.md)