Hi all, I have been going through the full reference guide making some
basic updates. I want all the translators to know, even though you will
see a checkin of pretty much every module spec, don't freak out! I've
made the following easy-to-change updates:

* Removed <?php and ?> tags (they aren't interesting in the examples,
sometimes indicate the code is executable by itself when it is not, and
are a general waste of space.

* Removed all 'require' and 'require_once' tags unless they are used to
make a point (again, not interesting and they bring up the debate of
autoloading vs. Zend_Loader vs. requires, which is not pertinent to the
examples at hand)

* Made all links print full URL's (no <a href='http://example.com'>click
here</a>, instead <a href='http://example.com'> http://example.com</a>)

I've also updated the grammar, spelling, and style used in the manuals
to make it more legible for both native-English and non-native-English
readers, as well as making all sections more consistent overall.

*You can update the examples when you have the time/inclination. There
are no semantic changes that have been made.*
*Don't worry about the text. The style changes will not be significant
enough to require re-translation in almost all cases. If re-translation
is required because of factual errors, I will post to fw-docs'.*

I'm doing this now to prepare our manual for rendering in different
formats, including in a single printable document.

Thanks.
,Wil

Reply via email to