Skip to content

Commit 76bb1e7

Browse files
perception -> signal + nits
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
1 parent 3e7f85e commit 76bb1e7

1 file changed

Lines changed: 3 additions & 3 deletions

File tree

src/articles/documentation-is-more-than-you-think.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,11 +34,11 @@ Some folks go even further and make documentation the core of it all, through [D
3434

3535
Regardless of the workflow or philosophy you choose, the key lesson is that documentation should be treated with care and priority, integrated as part of your product development. That is ultimately going to distinguish you from the competition, make your users happier, and increase adoption.
3636

37-
## It is a perception of quality
37+
## It is a signal of quality
3838

39-
The state of your documentation **is a perception of quality** about your product and company. If you want it to be seen as the "Apple of X", then your docs have to be equally polished.
39+
The state of your documentation **is a signal of the quality** of your product and company. If you want it to be seen as the "Apple of X", then your docs have to be equally polished.
4040

41-
Put yourself in the shoes of a user: they open your beautiful landing page, go in the docs to learn more and what they see is typos, inconsistencies, confusing navigation, and so on — you signaled your product is only looks, and if docs weren't given any polish, what can guarantee the product is any better or even worthy of their data, money, and time?
41+
Put yourself in the shoes of a user: they open your beautiful landing page, go to the docs to learn more and find typos, inconsistencies, confusing navigation, and so on — you signaled that your product is only looks, and if the docs weren't given any polish, what can guarantee the product is any better or even worthy of their data, money, and time?
4242

4343
If you want people to look into your product and believe it's a worthy investment, you have to show your company is mature and serious — and I don't mean that in a brand/tone way, it can be silly and fun, but you should always treat your users seriously and with respect.
4444

0 commit comments

Comments
 (0)