Premature documentation

… is the root of all evil:

On large-scale projects: (1) start with a piece you can do. (2) premature documentation is the root of all evil — don’t write documentation describing software that doesn’t exist. Build the code first.

Curtis Yarvin on Urbit, in response to a question from a redditor:

It seems that one of the biggest self imposed filters on people attempting development for the Urbit platform is the extensive new terminology, which overlaps with existing word meanings (albeit in entirely different namespaces). Now that a substantial number of people have viewed the documentation, do you believe that this terminology is useful? A mistake?

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s