On Thu, 2009-07-09 at 13:00 -0400, Matthew Daniels wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Eric Christensen wrote: > > On Thu, 2009-07-09 at 12:08 -0400, Matthew Daniels wrote: Would > > striking a lot of specific, step-by-step tasks from the UG offend > > any previous content writers? Is this the direction to go? What > > kind of step-by-step tasks are you proposing? Eric > > I would propose removing items which should be included in > documentation already shipped with software components. Examples of > some things I'd like to trim or rewrite are thing like the current OOo > section[1], or the description of KMyMoney[2]. These are things that > can either be found shipped with the programs or that are too common > sense to include in documentation (like explaining what your options > will be if you click on the "Edit" menu). These kind of small details > are also extremely version sensitive; these things could even change > between Fedora releases, meaning that the guide becomes inaccurate. > > Examples of the type of "generalized" information I'd rather see kept > are things that orient the user in the way Fedora is organized. > Comparing the GNOME desktop to Microsoft Windows would fit here; also, > explaining things like how and why one mounts/unmounts volumes. > Troubleshooting common problems should also be included, as well at > meta-information. By meta-information, I mean things like Package > Installation instructions -- there is documentation for that, but so > much of the User Guide depends on that process that I feel it needs to > be included anyway. > > - -- Matthew > > [1] > https://fedoraproject.org/wiki/User_Guide_-_Office_Tools#OpenOffice.org_Writer > [2] > https://fedoraproject.org/wiki/User_Guide_-_Financial_Software#Using_KMyMoney > -----BEGIN PGP SIGNATURE----- > Version: GnuPG v2.0.10 (Darwin) > Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org > > iEYEARECAAYFAkpWIjMACgkQ8q6Smu6Jjuv7FwCcD6ATaJe4lWlsOQ3eTinBIT8b > FScAnRXUDIViRM10IIoIw4Fo80iVsf1a > =Tr8X > -----END PGP SIGNATURE----- > Yeah, I agree with not reinventing the wheel when it comes to reiterating what is already written elsewhere. Maybe a link to where they can read more? - Eric
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list mailing list fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
