aboutsummaryrefslogtreecommitdiff
path: root/doc/README.md
diff options
context:
space:
mode:
authorRuben Beltran del Rio <ruben@unlimited.pizza>2022-05-01 15:10:56 +0200
committerRuben Beltran del Rio <ruben@unlimited.pizza>2022-05-01 15:10:56 +0200
commite8fcef96681425d431d03fa323747d7d6e61257c (patch)
tree0646922304ac38721b2f53485d1c1106d6c300d5 /doc/README.md
parent3260d5e90a30bbf57e3e5822aa84c23cee0411be (diff)
Add typedoc
Diffstat (limited to 'doc/README.md')
-rw-r--r--doc/README.md32
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/README.md b/doc/README.md
new file mode 100644
index 0000000..0d14a40
--- /dev/null
+++ b/doc/README.md
@@ -0,0 +1,32 @@
+forum / [Exports](modules.md)
+
+# Forum
+
+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`, `pact`,
+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
+- Stores that interact with the API should be tested using pact
+
+[node]: https://nodejs.org/en/
+[forum-server]: https://gitlab.com/rbdr/forum-server