Benutzer-Werkzeuge

Webseiten-Werkzeuge


Seitenleiste

friedhof:writing_it_down_makes_it_science

Dies ist eine alte Version des Dokuments!


Writing It Down Makes It Science

If a tree falls in a forest and no one is around to hear it, does it make a sound? (1)

Figuratively you could argue that your hacks/projects didn't happen without providing documentation - or at least the documentation would add significant value by enabling others to not make the same mistakes or advancing directly on your foundation.

If you happen to have a list of thing that you always wanted to write documentation on at some point - seize this opportunity and do it.

Status of the project or even if it was a success or not is irrelevant.

Cult of done-manifesto +

As supporters of the Cult of done-manifesto we thought it needed a small addition

  • There are three states of being. Not knowing, action and completion.
  • Accept that everything is a draft. It helps to get it done.
  • There is no editing stage.
  • Pretending you know what you're doing is almost the same as knowing what you are doing, so just accept that you know what you're doing even if you don't and do it.
  • Banish procrastination. If you wait more than a week to get an idea done, abandon it.
  • The point of being done is not to finish but to get other things done.
  • Once you're done you can throw it away.
  • Laugh at perfection. It's boring and keeps you from being done.
  • People without dirty hands are wrong. Doing something makes you right.
  • Failure counts as done. So do mistakes.
  • Destruction is a variant of done.
  • If you have an idea and publish it on the internet, that counts as a ghost of done
  • Done is the engine of more.
  • Writing it down makes it science. (2)

documentation hints

  • if you provide code, pictures, cad drawings, pcb layouts you need to add a license even if as simple as wtfpl

Session 1: härter-dokumentieren Sonntag

  • Sonntag, 6.10.2013 - 14-20Uhr
friedhof/writing_it_down_makes_it_science.1380831758.txt.gz · Zuletzt geändert: 2013-10-03 22:22 von excogitation