So there's a few things to be done to have the F9 UG ready for conversion to XML. Most of these have been noted on https://fedoraproject.org/wiki/User_Guide_tasks but I thought it would be good to list them out on the f-d-l as well.
Articles to be updated: KDE Guide, Xfce Guide, Media, Connecting to the Internet, Accessing the Web, Communications, Office Tools, Multimedia, Games, Photos, Desktop Sharing, Customizing the Desktop, Managing Software. The other articles may need to be touched up stylistically; take a look at Eawest's revision of https://fedoraproject.org/wiki/User_Guide-Financial_Software for a good example of the style we're looking for. Additionally, the GNOME desktop tour needs to be temporarily revised. John McDonough updated it for F10, which we can use when we get there, but we need that intermediate F9 version as well.
I would like to see the guide almost entirely F9'ed by the beginning of the hackfest so we can use that time to finish anything that's not done, ship to XML, and then jump right onto F10. If anyone can work on an article, please feel free to do so and make a note of it either on the UG tasks page, IRC, this list, or all of those so nobody gets confused and tries to redo your work.
Happy holidays to all.
-- Matthew Daniels
PS: Karsten has been kind enough to set up a User Guide project on fedorahosted.org (https://fedorahosted.org/userguide/). Please use this space to post request/suggestions/error tickets if you have any.
On Sat, Dec 20, 2008 at 03:50:37PM -0500, Matthew Daniels wrote:
PS: Karsten has been kind enough to set up a User Guide project on fedorahosted.org (https://fedorahosted.org/userguide/). Please use this space to post request/suggestions/error tickets if you have any.
Karsten, et al.,
You may want to m ove this under docs/userguide, as with our other documentation. This does two things -- it keeps our documentation together on the git.fedorahosted.org index, and it also alerts the Infrastructure team that it's part of our documentation set, in case there's some special treatment needed in the future for that set of projects.
There's not much involved in doing this -- really you're just moving a directory under /srv/git/docs on the fedorahosted.org server, and then people who have checkouts need to update the .git/config file in their current clone of the repository to point to the new location to continue without interruption.
On Sat, Dec 20, 2008 at 07:00:44PM -0500, Paul W. Frields wrote:
On Sat, Dec 20, 2008 at 03:50:37PM -0500, Matthew Daniels wrote:
PS: Karsten has been kind enough to set up a User Guide project on fedorahosted.org (https://fedorahosted.org/userguide/). Please use this space to post request/suggestions/error tickets if you have any.
Karsten, et al.,
You may want to m ove this under docs/userguide, as with our other documentation. This does two things -- it keeps our documentation together on the git.fedorahosted.org index, and it also alerts the Infrastructure team that it's part of our documentation set, in case there's some special treatment needed in the future for that set of projects.
That was my mistake, my first project setting up. It also didn't quite get the name I requested, 'user-guide', to match our other schemes.
There's not much involved in doing this -- really you're just moving a directory under /srv/git/docs on the fedorahosted.org server, and then people who have checkouts need to update the .git/config file in their current clone of the repository to point to the new location to continue without interruption.
I'll go back to the ticket and talk with jstanley about that, see if we can get the move and rename. I don't *think* there is anything in the repo yet, but I'll check. I haven't put anything in, fwiw. It's not pointing at f-docs-commits yet.
- Karsten
On Sat, Dec 20, 2008 at 03:50:37PM -0500, Matthew Daniels wrote:
take a look at Eawest's revision of https://fedoraproject.org/wiki/User_Guide-Financial_Software for a good example of the style we're looking for.
Elizabeth Ann's explanation of what she intended with that rewrite:
http://www.redhat.com/archives/fedora-docs-list/2008-October/msg00037.html
Figure a few hours per chapter to rewrite for that style. The formula is something like:
1 hour per printed page to rewrite 30 minutes per printed page to update technical details
'Course, I could be off with that; ccurran may chime in with better numbers, I hope.
- Karsten