update/rework documentation
update/rework documentation

document all the 0.3 features, move the features/advantages closer to
the top of the file (certainly to the top of the technical stuff). Make
the sample code more impressive by showing off the transformation
feature. Fix the indentation

fjg/sacy,pilif/sacy