User avatar
Tamas G @Tamasg@mindly.social
1mo
yup, or Readme content with a giant preface on the problem and "what we're trying to solve" as though it is a step by step useful breakdown, when in reality without explaining the core concepts and fundementals someone walking in can hardly make sense of it so then I'm left hunting down info in the codebase before even getting through the manual. Not "RTFM-ing" could now become a part of the design, not shear lazyness
1
1
0
0
User avatar
🇨🇦Samuel Proulx🇨🇦 @fastfinge@interfree.ca
1mo
@Tamasg The problem is AI doesn't understand the difference between developer documentation and user documentation. They both matter, but are for wildly different purposes, with wildly different audiences. None of the documentation Claude generates for me would be useful to anyone who wants to use the project. But I use it daily, to look back at previous decisions and understand how things fit together. Before a project is ready for real users, though, that all has to be moved into a development log folder and user facing documentation needs to be produced. By me.
0
0
1
0