@@ -49,6 +49,7 @@ to maintain.
49
49
* [ Using with Typescript] ( #using-with-typescript )
50
50
* [ Inspiration] ( #inspiration )
51
51
* [ Other Solutions] ( #other-solutions )
52
+ * [ Guiding Principles] ( #guiding-principles )
52
53
* [ Contributors] ( #contributors )
53
54
* [ LICENSE] ( #license )
54
55
@@ -199,6 +200,21 @@ independent from jest, and can be used with other tests runners as well.
199
200
I'm not aware of any, if you are please [ make a pull request] [ prs ] and add it
200
201
here!
201
202
203
+ ## Guiding Principles
204
+
205
+ > [ The more your tests resemble the way your software is used, the more confidence they can give you.] [ guiding-principle ]
206
+
207
+ This library follows the same guiding principles as its mother library [ dom-testing-library] [ ] .
208
+ Go [ check them out] ( https://github.com/kentcdodds/dom-testing-library#guiding-principles )
209
+ for more details.
210
+
211
+ Additionally, with respect to custom DOM matchers, this library aims to maintain
212
+ a minimal but useful set of them, while avoiding bloating itself with merely
213
+ convenient ones that can be easily achieved with other APIs. In general, the
214
+ overall criteria for what is considered a useful custom matcher to add to this
215
+ library, is that doing the equivalent assertion on our own makes the test code
216
+ more verbose, less clear in its intent, and/or harder to read.
217
+
202
218
## Contributors
203
219
204
220
Thanks goes to these people ([ emoji key] [ emojis ] ):
247
263
[ twitter-badge ] : https://img.shields.io/twitter/url/https/github.com/gnapse/jest-dom.svg?style=social
248
264
[ emojis ] : https://github.com/kentcdodds/all-contributors#emoji-key
249
265
[ all-contributors ] : https://github.com/kentcdodds/all-contributors
266
+ [ guiding-principle ] : https://twitter.com/kentcdodds/status/977018512689455106
0 commit comments