Remix.run Logo
cjs_ac 17 hours ago

> The RFC approach has several advantages over verbal alignment. First of all, it is more precise. The need to write forces the author to clearly structure their thoughts into a coherent logical narrative. While writing, the author has time to examine their proposed solution from different angles and clearly see pros and cons of it.

> Another advantage of the document over verbal explanation is that a well-written RFC leaves little room for misinterpretation. It can include diagrams, examples, or calculations to illustrate and support the idea.

> Finally, we can return and reread the RFC later. Human memory is unreliable; already after a day, details that were crystal clear in one’s mind start to get blurry. When these details are written down, it is easy to review them at any time.

‘You have to write things down, because spoken words disappear into the air,’ was one of the first bits of feedback I received in my teacher training.

> The most common objection is that writing proposals is “a waste of time” compared to writing code.

The extra time spent writing is actually spent thinking.

pjc50 16 hours ago | parent | next [-]

>> The most common objection is that writing proposals is “a waste of time” compared to writing code.

> The extra time spent writing is actually spent thinking.

Common theme for decades is "we can save a few days of planning with just a few weeks of programming".

But then there's the darker realization that sometimes the people you are working for are incapable of reasoning about planning artefacts or understanding how the system will look or operate simply from a document. So you need to present the system in small iterative chunks and repeatedly re-align expectations with reality: Agile.

And sometimes you genuinely need to do exploratory work which doesn't fit into a planning framework - actual research!

physicles 8 hours ago | parent [-]

> sometimes the people you are working for are incapable of reasoning about planning artefacts or understanding how the system will look or operate simply from a document

I’m wrestling with this now. Over my career I’ve seen a strong correlation between good writers and good software engineers, but not everyone fits this mold. Shorter cycles and more chances for communication and feedback are helpful here.

LordGrey 14 hours ago | parent | prev [-]

>> The most common objection is that writing proposals is “a waste of time” compared to writing code.

> The extra time spent writing is actually spent thinking.

Until someone decides that using ChatGPT to write your RFC is a good idea. Then you get something that looks great, but the person behind the prompt actually understands less.

EvanAnderson 14 hours ago | parent | next [-]

"Eventually they realized that this was something they were going to have to sort out, and they passed a law decreeing that anyone who had to carry a weapon as part of his normal Silastic work (policemen, security guards, primary school teachers, etc.) had to spend at least forty five minutes every day punching a sack of potatoes in order to work off his or her surplus aggressions. For a while this worked well, until someone thought that it would be much more efficient and less time-consuming if they just shot the potatoes instead. This led to a renewed enthusiasm for shooting all sorts of things..."

- Douglas Adams, "Life, the Universe, and Everything"

(It took an unreasonably long time to find this quote!)

bccdee 6 hours ago | parent | prev | next [-]

Oh I really worry about that. AI code at least needs to pass unit tests, but there's no way to prove that the ideas in an AI document make sense until you try them and run into issues. Writing is thinking. If you let a robot do it, you aren't.

physicles 8 hours ago | parent | prev | next [-]

I’m currently fighting the “don’t use Gemini to write internal documents” war at my company. It’ll be long and hard, but I think I’ll eventually prevail.

Every time someone throws a document written by AI at me, it feels so disrespectful.

fpsvogel 14 hours ago | parent | prev [-]

And anyone who sees the document is less likely to read it!