when writing a new tool/software, write doc first, explaining how it works. Then, actually writing the code is much easier :)