I do not like the idea to 'clutter' up language-snippets.ent with notes belonging to only a specific extension. I think this file should only contain general notes. Extension specific notes could easily included like note-openssl-cnf.xml.
Translations pick up that language-snippets.ent, keep it in sync and untranslated extensions include translated notes.This looks a bit weird and unprofessional.
Having files for notes in the reference/* folders is bad because of livedocs (if it ever goes live...)
I don't know how hard is to translate the manual and this file, but why not having all notes together?
If livedocs have any problems with that then we can code the needed stuff into it :) Sooner or later :) About the mixed language files. Even we have the &return.sucess; entitiy, which is used everywhere, and that causes mixed language pages, or the example numbering also causes that, so that argument does not stand well.
Goba
