I would like to rework my primary datastructure and my list of specs is long.
I have made a writeup of the modifications I want to do. 
http://aeditor.rubyforge.org/buffer2/

Any advices to what I should do on my document?
do you have suggestions for sections?

Also constructive critisism is welcome.

--
Simon Strandgaard