Docs Deserve More Respect

Re:Docs Deserve More Respect by esafak on Thursday December 28, 2023 @05:02PM (#38799284)

If their utility is in question, then the company does not consider withdrawing them extreme! If it turns out to be harmful, QED! When you perform a statistical test, you only have to expose as many users to it for as long as needed to achieve statistical significance. Not all users will be affected; you need to be able to make a comparison.

The foregoing assumes the alternatives are having docs or not. If the alternatives are something else, such as having different kinds of documentation, then the test treatments will be chosen accordingly.

[ Parent | on HN ]

Re:Docs Deserve More Respect by remoquete on Thursday December 28, 2023 @05:48PM (#38799726)

Would you do the same with, say, the UI? Or an API?

[ Parent | on HN ]

Re:Docs Deserve More Respect by esafak on Thursday December 28, 2023 @06:35PM (#38800082)

Again, you have to define the alternatives. APIs have launch success criteria too. One way to assess zero-to-one initiatives, if that is what you are asking about, is to start measuring before the project is complete. For a UI, that could be as soon as it is usable but before all the features are implemented. Then you will be able to able to estimate the value of the remaining features.

You might like to read https://hubbardresearch.com/publications/how-to-measure-anyt...

[ Parent | on HN ]