Hi, On Mittwoch, 16. Mai 2007, Thomas R. Jones wrote:
[...]
I was referring to educational level. I try as much as possible when authoring documentation to adhere to a baseline level. e.g. the target grade for readability formulas, kincaid, flesch, gunning-fog, etc....
Ahh ok. Thanks for the explanation, I was barking at the wrong tree. ;)
Also, is there not a common novell/suse/opensuse entity file for inclusion into all documents?
For LfL we have one file that includes every topic. Is that what you mean?
More with regards to urls, project titles, etc... I have written for fedora, and they have a common file that includes all project titles, urls and such for all community entities. Obviously this keeps references more consistent throughout the community contributions. Not to mention if a project were to change names or urls; it can be disseminated throughout all documentation with a simple change and then rebuild documents.
Does anything like that exist currently for opensuse-doc? If not, I would like to formally request such. I don't mind doing the coding/research to achieve a comprehensive and consistent resource for all authors. Let me know. I can work up a prototype if the community would be so inclined.
Ah, now it makes sense. Yes, we have an entity file[1] that is included in each topic. For example, you can find product names, the LfL URL, example users, etc. Bye, Tom ---- [1] https://forgesvn1.novell.com/svn/lfl/trunk/books/en/xml/entity-decl.ent -- Thomas Schraitle ---------------------------------------------------------------------- SUSE LINUX GmbH >o) Documentation Specialist Maxfeldstrasse 5 /\\ 90409 Nuernberg _\_v http://en.opensuse.org/Documentation_Team --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-doc+help@opensuse.org