Dear ceriak,
please do not change documentation in a way where the meaning of the content
changes.
You rewrote how translations have to be used and your new description is
wrong.
Also the docbook standard has been changes so it does not fit anymore.
I recommend all others not to translate this commit until it has been fixed.
Greetings
Thomas Weidner, I18N Team Leader, Zend Framework
http://www.thomasweidner.com