There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
-
There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
-
@eviloatmeal But it does!! They just come in the form of "here's some non-working code" forcing you to explain what went wrong and tell it to go back to the drawing board.
-
There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
@tael at least some of the time it's because bosses refused to allocate time for improving documentation for humans and now people are tricking into letting them invest in it because "it's for AI"
-
There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
Speaking from the PoV of one who came up through developer ranks, and was blessed with some truly excellent tech writers for documentation, i think it comes down to 2 things.
Writing a spec, is very different from documentation. Devs can be pretty good about describing what they want, but terrible at explaining how to use it. That's why you need excellent tech writers.
Second, as prompt, the spec doesn't talk back. Writing for humans involves negotiation, not just direction.
-
There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
Because any idiot can write the first one, but the second one is hard?
️ -
There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
Because part of that documentation can also be written by the same machine that is going to consume it later
-
@petealexharris @tael Point.
-
Because part of that documentation can also be written by the same machine that is going to consume it later
@javascript I foresee no issues with this process
-
There really is an opportunity to do some interesting psychological research on why people are so much more willing to write documentation and detailed instructions for AI agents to write code for them than for other human beings to write code for them.
@tael Because writing for AI agents gets them an immediate reward, but writing for others barely gets recognized, in most organizations.
-
@tael at least some of the time it's because bosses refused to allocate time for improving documentation for humans and now people are tricking into letting them invest in it because "it's for AI"
@technomancy @tael i am sure this is a big part of it. being told to write it by your boss does a lot for motivation.
but in addition to that, the llm is supposed to take the work you did on the documentation and turn it into work you don't have to do elsewhere. it's a fairly straightforward trade with little ambiguity and that's a very attractive offer.
writing for humans, otoh, means you may or may not get work done on the things you want to prioritize, and they probably won't have read the docs you spent so much time on.
this is mostly independent of the quality of the results. i think a lot of people value the direct feedback from their efforts much, much more than getting high quality feedback. -
R relay@relay.publicsquare.global shared this topic
