Conversation

Notices

1. Embed this notice
   13 barn owls in a trenchcoat (hauntedowlbear@eldritch.cafe)'s status on Monday, 13-Nov-2023 22:52:26 JST 13 barn owls in a trenchcoat

   in reply to

   • Toran Shaw
   • xuxxux

   @toran @xuxxux You can also be too close to your software and your development environment.

   Hell, I write documentation professionally, and I know the docs I produce for my own programs aren't as good as those I produce for other people's, because things I think are "obvious" about my own software are, in fact, only obvious to me.

   • Embed this notice
     Toran Shaw (toran@pkm.social)'s status on Monday, 13-Nov-2023 22:52:27 JST Toran Shaw

     in reply to

     • xuxxux

     @xuxxux @HauntedOwlbear and they often assume a certain level of technical ability, on behalf of their end user.

   • Embed this notice
     xuxxux (xuxxux@social.tchncs.de)'s status on Monday, 13-Nov-2023 22:52:28 JST xuxxux

     @HauntedOwlbear can’t say this often enough: documentation by developers is often written from a different perspective than the perspective of users. Developer documentation often skips the obvious things and talks about details. The problem is that „the obvious“ things are often the things new users struggle the most with. I know what I speak of, my documentation sucks