Mailinglist Archive: opensuse-doc (50 mails)

< Previous Next >
Re: [opensuse-doc] LfL: Few Questions
  • From: Thomas Schraitle <thomas.schraitle@xxxxxxx>
  • Date: Wed, 16 May 2007 16:41:54 +0200
  • Message-id: <200705161641.54945.thomas.schraitle@xxxxxxx>
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@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >