Add topics store pact tests

[rbdr/forum] / README.md

diff --git a/README.md b/README.md
index 0ab0174399336b5518872bb0c8680fe0f2f91fda..e78b591668d24695a893161315fe03c15ab553c5 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,3 +1,28 @@
 # Forum
 
-A forum system for the year 3000
\ No newline at end of file
+A forum for the year 3000.
+
+## What you will need to get started
+
+This project uses [node][node] for most of its development processes.
+Once you have node installed according to the instructions there, run
+`npm install` from the root of the project.
+
+For local development serve the page by running `npm run dev` from the
+root of the project.
+
+This project depends on the [forum server][forum-server], so make sure
+that's running before starting.
+
+## Testing
+
+You can run tests with `npm test`. The tests use `testing-library` and
+`jest`.
+
+Here's some short guidelines:
+  - Every component that receives props or changes state should be tested.
+  - Test expected outcomes, not implementation details.
+  - Avoid mocking unless it's an external call
+
+[node]: https://nodejs.org/en/
+[forum-server]: https://gitlab.com/rbdr/forum-server