On 06/02/09 17:58, Per Eriksson wrote:
Hi everybody,
There is a new draft uploaded in issue 102393 for the new Setup Guide
for 3.0.
Please comment its changes.
A few comments/questions from a quick scan I did of the draft doc:
Under System Requirements > For accessibility > Linux
- It states that Gnome 2.6 is required. What about.. KDE4, KDE3, and
other window managers? Will accessibility stuff only work in Gnome?
(highly unlikely given that GTK libs can be loaded regardless of window
manager you use)
Windows Installation
- There seems to be quite liberal use of the (R) symbol next to every
"Windows". Is this necessary? It does not seem to be so according to:
http://www.microsoft.com/about/legal/trademarks/usage/windows.mspx
- Notes: The language used is quite formal and archaic. They are
difficult to read, and should be simplified.
- The link to documentation.openoffice.org/faq has a spelling error
in the URL.
- Step 4: Should only be done if there is an issue with the virus
protection software. This is not really a step we want to suggest or
recommend as a normal part of the installation procedure is it?
Single-User Installation > Execute the installation program
- Note: The wording of this note is not so nice. "returning to the
prior state is tedious" is not the nicest thing to say. The last two
sentences should be reworded to make it less negative sounding.
- Below the screen cap of the Customer Information window, there is a
reference to OOo 2.x
Multiple User Environment under Windows
- Note: another reference to "tedious" which should be removed/reworded.
Linux Install
- General comment: What about the (new) Java installer that comes with
OOo now? The Linux section only details rpm and deb.
Removal
- Starts with "I found the following useful:" Seems to be an odd way
to begin a section. This is scattered through this section, and it
reads more like a personal email than what I woudl expect from a setup
guide.
- "one simply has to enter" is not a common grammatical construction
in American English.
- Warning: The warning is referencing very old FC and openSUSE
releases. SuSE9.3 is no longer supported, and I belive the same applies
to Fedora 3. (these Linux versions are more contemporary with the last
1.x versions of OOo,and maybe the very early beta 2 releases).
Slackware? Does anyone use this distro anymore? Is it not better to
simply refer Slackware users to their docs that explain how to
setup/install RPMs on Slackware? I guess my question here is... how
many specific distros do we single out? The answer here can also apply
to the other OOo Admin docs... where at this point only RPM and DEB are
covered. Do we detail FreeBSD, Gentoo, Slackware, DSL, gOS, Arch etc.
etc, or do we have a general Other Linux section (like there is an Other
Unix section) that loosely covers the other possible ways to install?
C.
--
Clayton Cornell ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org
