if you want an example of C code
http://us.st.com/stonline/books/pdf/docs/7091.pdf is an appnote from ST micro which show one way of making very maintainable code. Whatever you do, do not set out with your first attempts on the premise that comments and such can come later, it will be 100 times more difficult to change than to start right.

Erik