Hi Clayton,
ccornell - OpenOffice.org skrev:
That's a tough question that Tech Writers struggle with all the time.
Who is the audience? Who are we writing for? Are they experienced
users? Novices? Do we provide a tutorial explaining all the options
for a specific OS? Do we assume they know a little.. a lot?
With Gentoo, I think that explaining how emerge works goes beyond the
scope of the Setup Guide. If this information is necessary, it would
be better to refer to the emerge docs on the Gentoo website... just as
you would do for yum/rpm and RedHat, zypper/YaST and openSUSE,
apt/dpkg and Ubuntu/Debian etc., etc. To contrast this with Windows,
you don't go into depth about how the msi installer works and all the
options available to the msi installer (or do you?)... so why do the
same for Linux?
I agree with you here, and that is why I raised the question. I think
the level is explained in the foreword.
I would make a reference to the documentation for each platforms
commands/package manager for reference. At the same time decrease the
in-depth documentation about emerge.
...And, I've now got almost complete instructions for Solaris! :o)
Per
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org
