zulip

Commit Graph

Author	SHA1	Message	Date
Sharif Naas	29ef37d03b	docs: Fix broken wording in testing/philosophy.md.	2020-06-08 11:13:32 -07:00
Sharif Naas	3b120220a7	docs: Reword sentence to be more concise while fixing broken wording. The previous wording was slightly broken, but this commit changes the wording beyond just fixing that issue, to be more concise.	2020-06-08 11:13:32 -07:00
Sharif Naas	37be21cebe	docs: Improve readability of a sentence in testing/philosophy.md. Previously, it was unnecessarily difficult to parse the sentence to determine that "HTTP response" and "internal state of the server following the request" are the coherent ideas. Even if length wasn't an issue, e.g. "... and checking both the A and B are correct", the sentence still feels a bit fragile without a "that". Since the second phrase is indeed relatively long, and "internal state of the server" is a reasonable guess for the second coherent idea, the "the" helps to reset the reader's expectation about where the next coherent idea starts, and ends. Lastly, having "both" in front of the two phrases encourages an assumption that they're shorter (which is especially problematic for the second phrase), while having it at the end of the sentence helps to anchor the end of the second phrase; this is especially true since the absence of "both" before that point encourages an assumption that you haven't finished reading yet, given that two things have been mentioned.	2020-06-08 11:13:32 -07:00
Sharif Naas	fb969de765	docs: Fix typos in testing/philosophy.md.	2020-06-08 11:13:32 -07:00
Stefan Weil	c220b971ae	docs: Fix some typos in documentation (most of them found and fixed by codespell). Signed-off-by: Stefan Weil <sw@weilnetz.de>	2020-03-17 05:57:10 -07:00
Mateusz Mandera	00de35b28a	docs: Typo fixes in testing/philosophy.md.	2020-02-04 13:58:13 -08:00
Tim Abbott	32ff28bf24	docs: Add an article explaining our testing philosophy.	2020-02-03 16:32:35 -08:00

7 Commits