Mailing-List: contact doc-help@openoffice.apache.org; run by ezmlm
Precedence: bulk
Reply-To: doc@openoffice.apache.org
To: doc@openoffice.apache.org
From: "Keith N. McKenna" <keith.mckenna@comcast.net>
Subject: Re: [DISCUSS] Places for Installation, Startup, Troubleshooting,
 Caveats, Tips, Workarounds, and maybe FAQ?
Date: Wed, 27 Jul 2016 13:00:07 -0400
Lines: 212
Message-ID: <nnapb3$1d5$1@ger.gmane.org>
References: <00a401d1e5d1$98136af0$c83a40d0$@acm.org>
 <00cd01d1e5d8$3e25db20$ba719160$__23822.2281136133$1469384534$gmane$org@acm.org>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
 protocol="application/pgp-signature";
 boundary="lSCEpOKE8G5HmdO367hOvrfb52jfjsIoF"
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:43.0) Gecko/20100101
 Firefox/43.0 SeaMonkey/2.40
In-Reply-To: 
 <00cd01d1e5d8$3e25db20$ba719160$__23822.2281136133$1469384534$gmane$org@acm.org>

--lSCEpOKE8G5HmdO367hOvrfb52jfjsIoF
Content-Type: multipart/mixed; boundary="7EagQG7Md3ahvrPh5h4RssvWmoX3l7R1m"
From: "Keith N. McKenna" <keith.mckenna@comcast.net>
Newsgroups: g,m,a,n,e,.,c,o,m,p,.,a,p,a,c,h,e,.,o,p,e,n,o,f,f,i,c,e,.,d,o,c
Subject: Re: [DISCUSS] Places for Installation, Startup, Troubleshooting,
 Caveats, Tips, Workarounds, and maybe FAQ?
References: <00a401d1e5d1$98136af0$c83a40d0$@acm.org>
 <00cd01d1e5d8$3e25db20$ba719160$__23822.2281136133$1469384534$gmane$org@acm.org>
In-Reply-To: <00cd01d1e5d8$3e25db20$ba719160$__23822.2281136133$1469384534$gmane$org@acm.org>

--7EagQG7Md3ahvrPh5h4RssvWmoX3l7R1m
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Dennis E. Hamilton wrote:
> Still ...
>> [BCC to dev and users lists - please keep the conversation on doc@
>> for now, at least by BCC, since it pertains to use of the
>> wiki(s).]
>=20
> Of course, I could simply be over-thinking this whole thing and it
> would be more valuable to do something.
>=20
[knmc]
Sometimes over thinking can be a good thing as it can lead to needed
improvements. We just have to keep in mind what we can do with the
available resources.

> I still would like any feedback that there is before investing in
> something like this.
>=20
[knmc]
I will try to put something together over the next few days as far as
constructive feedback

> The need for development of hotfix procedures for end-users led me to
> elevate this lingering topic of mine for discussion.  I regret not
> anticipating the need for better information for situations like that
> and user trouble-shooting as well.
>=20
[knmc]
end user procedures for hot fixes need to be a part of an over-all
process for dealing with the root cause of the fix especially for
security issues.
> - Dennis
>=20
Pax
Keith
>> -----Original Message----- From: Dennis E. Hamilton
>> [mailto:dennis.hamilton@acm.org] Sent: Sunday, July 24, 2016 10:34=20
>> To: doc@openoffice.apache.org Subject: [DISCUSS] Places for
>> Installation, Startup, Troubleshooting, Caveats, Tips, Workarounds,
>> and maybe FAQ?
>>=20
>>=20
>> I notice that the User Guide draft does not provide connection to
>> topics around installation, startup, and so on, at least not at the
>> top level,=20
>> <https://wiki.openoffice.org/wiki/Documentation/UserGuide>.
>>=20
>> The Apache OpenOffice Documentation Project page is project
>> descriptive, rather than documentation descriptive, at
>> <https://wiki.openoffice.org/wiki/Documentation>.  This page has a=20
>> mix of old and somewhat recent material and a variety of formats
>> and works-in-progress.
>>=20
>> I am particularly interested, myself, in information about
>> installation, start up, ways of starting work with documents,
>> saving and locating documents, tips for configuring for careful and
>> systematic operation as well as trouble-shooting, working-around
>> common problems, and limitations to be known about.  I am also
>> interested in that information being well-illustrated.  My
>> priority, by the way, is Windows first, since that represents over
>> 85% of our user community measured by download statistics.
>>=20
>> These don't seem to be part of the User Guide project but there are
>> a variety of places where better information could be provided.
>>=20
>> It seems to me that there are three ways to have the supporting=20
>> documentation address this.
>>=20
>> 1. Add a section to the user guide for covering Installation,=20
>> Configuration, Operation, Troubleshooting, and Removal.  It would
>> need to deal with separation of the different platforms (and their
>> versions) in some clean way so that users on a particular platform
>> can find what is pertinent to them and requires knowing their
>> computer operating- system when it is not the same for all
>> platforms.  It would also need to deal with differences in AOO
>> version functionality/caveats in some manner.
>>=20
>> 2. Use the current structure and update and add the information
>> that seems to be important for providing the kind of documentation
>> support I am speaking of, employing/expanding HOWTOs and the
>> Frequently Asked Questions to tie into such material.
>>=20
>> 3. Maybe some combination, although cross-referencing might not
>> serve users well unless it is smooth and frictionless (especially
>> around users not losing their place based on what they are looking
>> into).
>>=20
>> Down the road, I would think it would be good to move The
>> Documentation Project to a DocumentationProject wiki topic, and
>> have current relevant documentation at the Documentation topic.
>> Older material about unsupported software could move to a separate
>> topic page (PreviousDocumentation ?) and cleaned up, and be
>> accessible from the top-level Documentation topic.
>>=20
>> Is there some coordination required about this, so that things
>> don't be left in a broken, disconnected state?  I think the
>> material could be migrated in a way that keeps everything connected
>> even as material is morphed into a new structure.
>>=20
>> - Dennis
>>=20
>> PS: I notice there were no responses to this question about how
>> inter- version changes or specific-version items are identified.
>>=20
>> PPS: Something else that needs to be done is cleanup around what
>> is under PDL and what is not. I would thing that needs to be
>> attended to in separation of Apache Licensed material and anything
>> that must be retained under PDL.
>>=20
>>> -----Original Message----- From: Dennis E. Hamilton
>>> [mailto:dennis.hamilton@acm.org] Sent: Sunday, January 31, 2016
>>> 18:17 To: doc@openoffice.apache.org Subject: [QUESTIONS] Dealing
>>> with AOO Inter-Version Changes
>>>=20
>>> I notice that there is checking of documentation against current=20
>>> releases of Apache OpenOffice, although that does not seem to be=20
>>> reflected in the texts themselves, once User Guide pages are
>> designated
>>> as stable/"published".
>>>=20
>>> I know there were a couple of behavioral changes in AOO 4.1.2
>>> although that might not show at the current level of
>>> documentation detail.
>>>=20
>>> I wonder how changes to AOO that are user-perceived will be
>>> reflected
>> in
>>> the documentation.  Is not the older form to be maintained so it
>>> can
>> be
>>> found by someone who is looking at such a version?  Also, would
>>> we
>> want
>>> to start marking the first version for which a page or chunk of
>> content
>>> is current?
>>>=20
>>> Perhaps that is covered somewhere in the documentation guidance.
>>> I would be grateful if someone could point me to where this sort
>>> of change-accounting and feature-progression has been decided.
>>>=20
>>> - Dennis
>>>=20
>>> PS: Although these questions struck me about the User Guide, if
>>> you
>> look
>>> at the top-level of the MediaWiki documentation section, there
>>> are
>> many
>>> items that are specific to older versions that are (or may be)
>> obsolete
>>> with respect to newer versions of OpenOffice.
>>>=20
>>>=20
>>>=20
>>> -- Dennis E. Hamilton orcmid@apache.org dennis.hamilton@acm.org
>>> +1-206-779-9430 https://keybase.io/orcmid  PGP F96E 89FF D456
>>> 628A X.509 certs used and requested for signed e-mail
>>>=20
>>>=20
>>>=20
>>> ---------------------------------------------------------------------=

>>>
>>>=20
To unsubscribe, e-mail: doc-unsubscribe@openoffice.apache.org
>>> For additional commands, e-mail: doc-help@openoffice.apache.org
>>=20
>>=20
>> ---------------------------------------------------------------------
>>
>>=20
To unsubscribe, e-mail: doc-unsubscribe@openoffice.apache.org
>> For additional commands, e-mail: doc-help@openoffice.apache.org


--7EagQG7Md3ahvrPh5h4RssvWmoX3l7R1m--

--lSCEpOKE8G5HmdO367hOvrfb52jfjsIoF
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Using GnuPG with SeaMonkey - http://www.enigmail.net/

iQEcBAEBCAAGBQJXmOifAAoJEH0fu5UhGmBCF6YIAK3B5/dHfRywOeDVfiCjhi9Z
EMUUYTZL1FAubCkN9Y3nvBvzsmotOHVxaHMzumQmPzqmRhfBAKqLXdr31H/dCCuT
HQ0QdEBXgYIIYCorFMQzsnQ0JfUP/fXo/xU370G913tu+Whnr6FGou+xxKh5tGfL
A/Ya0JZn6LhTOS24TxLb8F5+2mIEgwyg++UzQ9g5yKk6rhCiHlg3NXi1hItFad5R
fAeLNAAz0TGUjJfd9DHn3wIiiDsvU0kzkhOiIc34j7dmhba1QFfZ5JoRRLJ9TgND
nOQa+h3i0UYPKcn8Bmv9v1or050o88qZrD8euTH4VXIcSImWRTxtCW57xK6MGdM=
=mW8f
-----END PGP SIGNATURE-----

--lSCEpOKE8G5HmdO367hOvrfb52jfjsIoF--