feature: add docs for testing section

[bencodezen]

The proposal is here is not to serve as a comprehensive solution but provide some high level guidance for what people can expect in the testing ecosystem for Vue.js, but then route them to more in-depth guides for whatever topic they choose to dive into.

For example, @JessicaSachs and I had a conversation about distinguishing test runners from unit tests. While I wanted to include it in this section, I'm currently of the opinion that deeper guidance on testing methodologies and such should be rerouted to the Testing Team's own docs (which I will be happy to add contributions).

But the grander vision here is to give official testing resources a better platform where people can easily find those resources and work as a partner with them rather than try to replace them.

I look forward to your feedback!

[JessicaSachs]

@bencodezen I remember we were considering having the 3rd party tool authors provide the blurbs for accuracy. Was that done?

[bencodezen]

@bencodezen I remember we were considering having the 3rd party tool authors provide the blurbs for accuracy. Was that done?

@JessicaSachs Not yet. The descriptions from the 3rd party tools currently come from their website / own marketing with some editing (i.e., Jest's description is "Jest is a delightful JavaScript Testing Framework") of adjectives that seem more like subjective commentary (i.e., delightful).

I realized that contacting the various frameworks would be fair involved and didn't want to delay people having the chance to review it, but still certainly intend on doing so.

Do we have points of contact for these libraries beyond cold calling each website / GitHub maintainer?

[JessicaSachs]

I did a lot of rewording and only some content changes. I hope this helps! Please feel free to take what you need from the suggestions.

[lmiller1990]

We should link to the docs for VTU next: https://vuejs.github.io/vue-test-utils-next-docs/guide/introduction.html

VTU v1 is only for Vue 2.

[afontcu]

I assume that eventually we'll merge both docs (to let users search through v1 docs), so the URL would be the same one.

[lmiller1990]

Great, I like that we do not attempt to teach testing in the main docs anymore, but link to more detailed resources.

[lmiller1990]

I think @JessicaSachs review is great. I left some random notes, I definitely agree we should not go too deep here and leave the heavy lifting to the respective libs and their own docs.

I remember we were considering having the 3rd party tool authors provide the blurbs for accuracy. Was that done?

For testing-library, @afontcu is maintaining that, maybe he could write something for this particular library.

[afontcu]

Thanks for this! It looks great :) I've added several suggestions here and there, but I love the general tone.

---

The only thing I feel this docs are missing is mentioning that Vue Testing Library and Vue Test Utils run on top of a test runner such as Jest. I'm not entirely sure this is understandable right now, as it appears that Jest is only useful to run unit tests.

[JessicaSachs]

I had the same thought and was going to write something like "The unit test runner and the component test runner can be the same tool' and then I felt like it was too in the weeds.

…

On Fri, Jun 5, 2020 at 4:08 AM Adrià Fontcuberta ***@***.***> wrote: Thanks for this! It looks great :) I've added several suggestions here and there, but I love the general tone. ------------------------------ The only thing I feel this docs are missing is mentioning that Vue Testing Library and Vue Test Utils run on top of a test runner such as Jest. I'm not entirely sure this is understandable right now, as it appears that Jest is only useful to run unit tests. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#112 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAVL4BEOMFPIXE3DJ7N7RODRVCRWTANCNFSM4NSVWNPA> .