From Fedora Project Wiki

m (Added a tip about Pirut.)
(Changed category.)
 
(92 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Category:Fedora Docs content tasks for new contributors]] [[Category:Fedora Docs content tasks for experienced contributors]]
'''''Tasks currently target: Fedora 12 User Guide'''''


''Tasks currently target: Fedora 9 User Guide''
== Task List ==


== New contributor tasks ==
The task list below has four stages:
;Fact Check: This stage just changes all factual information so that it syncs up with the facts for F12.  If the default browser happens to be Dillo instead of Firefox for this release, the Fact Check stage should reflect this after completion.


=== Writing and editing tasks ===
;(Re)write Chapter: This stage is for two things: re-fact checking and then editing the formatting and organization of sections so that it lines up with all of our conventionsThis could mean anything from fixing headers to putting in admons (like the ones at the bottom of this page) to making sure that the standard installation process is referenced instead of including it inline.
'''''Note:''''' When fact checking, make sure you find all the references to Pirut/Pup.  That's one of the biggest changes from the old UG to F9.
{|
|-
| Chapter || Status || Fact check || (Re)write chapter || Edit/wordsmith || Edit format/XML conversion
|-
|  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Introduction]]  || ''Nothing'' || Done[[User:Kishan|Kishan]] 19:02, 23 September 2008 (UTC) || ''Not required?'' || ''Done[[User:Kishan|Kishan]] 19:02, 23 September 2008 (UTC)'' || ''Assign me''
|-
| [[User_Guide-Desktops]] || ''Nothing'' || ''Done[[User:Kishan|Kishan]] 19:19, 23 September 2008 (UTC)'' || ''Assign me'' || ''Done[[User:Kishan|Kishan]] 19:19, 23 September 2008 (UTC)'' || ''Assign me''
|-
| [[User_Guide-Logging_into_the_Desktop]] || ''Nothing'' || ''Done[[User:Kishan|Kishan]] 20:03, 23 September 2008 (UTC)'' || ''Assign me'' || ''Done[[User:Kishan|Kishan]] 20:03, 23 September 2008 (UTC)'' || ''Assign me''
|-
| [[User_Guide-Tour_of_the_GNOME_Desktop]] || ''Nothing'' || ''Done[[User:Jjmcd|JohnMcDonough]] 19:55 21 Oct 2008 (UTC)'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Tour_of_the_KDE_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Tour_of_the_Xfce_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Using_Media]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Connecting_to_Internet]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Accessing_the_Web]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Communications_(Email,_IM)]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Office_Tools]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Financial_Software]]  || ''Nothing'' || ''Was completed by Eawest. (--[[User:Danielsmw|Danielsmw]] 05:02, 8 December 2008 (UTC))'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Playing_Multimedia_(Music_&_Video)]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Playing_Games]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Managing_Photos]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Sharing_Your_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Customizing_the_Desktop]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
| [[User_Guide-Managing_Software]]  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|}
 
==== Sample: how to flag content ====
 
When flagging content that needs to be updated, include as much detail as you have availableUse this format to write a comment directly in the body of the content, in the location you are flagging as needing an update:


<pre>
;Edit/Wordsmith: This is for the English majors.  Make the page grammatically sound while keeping our conventions and a technical writing style in mind. Extra points go for stylizing the writing as long as it doesn't conflict with the core goals of readability and simplicity in comprehension.
''Content needs updating(write details of what needs updating here,
followed by the special symbol that marks your comment with  
your username and timestamp.) ~~~~''
</pre>


=== Project management tasks ===
;Edit Format/XML Conversion: Somebody get this chapter into DocBook XML!


{|
{|
|-
|-
| Task || Assigned to || Status
| Chapter || Status || Fact check || (Re)write chapter || Edit/wordsmith || Edit format/XML conversion
|-
| Copy over old F9 chapter content from [[Docs/Drafts/DesktopUserGuide]] to the new pages|| [[User:Kishan]] || Completed
|}
 
== Experienced contributor tasks ==
 
 
=== Writing and editing tasks ===
 
{|
|-
| Chapter || Status || Final fact check || Final wordsmith || Final stylesmith || XML conversion
|-
|  || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
|-
|-
| [[User_Guide-Introduction]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Introduction]] || Done, provisionally || Do again before XML || Done (danielsmw) || n/a || (do this last)
|-
|-
| [[User_Guide-Desktops]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - The Fedora Desktops]] || || || || ||  
|-
|-
| [[User_Guide-Logging_into_the_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Logging in]] || Draft || In progress || Rewritten (danielsmw) || ''Assign me!'' || Not ready
|-
|-
| [[User_Guide-Tour_of_the_GNOME_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Tour of the GNOME Desktop]] || || || || ||  
|-
|-
| [[User_Guide-Tour_of_the_KDE_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Tour of the KDE Desktop]] || || || || ||  
|-
|-
| [[User_Guide-Tour_of_the_Xfce_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Tour of the Xfce Desktop]] || || || || ||  
|-
|-
| [[User_Guide-Using_Media]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Media]] || || || || ||  
|-
|-
| [[User_Guide-Connecting_to_Internet]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Connecting to the Internet]] || || || || ||  
|-
|-
| [[User_Guide-Accessing_the_Web]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Accessing the Web]] || || || || ||  
|-
|-
| [[User_Guide-Communications_(Email,_IM)]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Communications]] || || || || ||  
|-
|-
| [[User_Guide-Office_Tools]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Office Tools]] || || || || ||  
|-
|-
| [[User_Guide-Financial_Software]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Financial Software]] || || || || ||  
|-
|-
| [[User_Guide-Playing_Multimedia_(Music_&_Video)]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Playing Multimedia]] || || || || ||  
|-
|-
| [[User_Guide-Playing_Games]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Playing Games]] || || || || ||  
|-
|-
| [[User_Guide-Managing_Photos]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Managing Photos]] || || || || ||  
|-
|-
| [[User_Guide-Sharing_Your_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Sharing Your Desktop]] || || || || ||  
|-
|-
| [[User_Guide-Customizing_the_Desktop]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Customizing the Desktop]] || || || || ||  
|-
|-
| [[User_Guide-Managing_Software]] || ''Nothing'' || ''Assign me'' || ''Assign me'' || ''Assign me'' || ''Assign me''
| [[User Guide - Managing Software]] || || || || ||  
|}
|}


== Notes to Contributors ==
=== Application Installations ===
Whenever we discuss an application not installed by default, we should put a note about having to install it.  The note should look like this:
* To install the package '''claws-mail''', read [[User Guide - Managing Software|the chapter on managing software]].  You can install '''claws-mail''' by either [[User Guide - Managing Software#Installing Software|using the PackageKit application]] or on the command line by [[User Guide - Managing Software#Installing Software 2|using Yum]].  More information about Claws Mail is available at: http://claws-mail.org/.
Of course, this should be edited according to the application name, package name, and application home page, but try to use this template for consistency's sake.
* Also note that I just made this convention up, so don't feel like you should have known this before.  If you have suggestions or comments, let me know.
--[[User:Danielsmw|Danielsmw]] 15:08, 25 February 2009 (UTC)


=== Project management tasks ===
=== Advanced Topics ===
Whenever we add something that would be nice to have in the user's guide but isn't necessary for the basic desktop user who just migrated fresh from Windows (example: discussion of FTP programs, advanced discussion of yum on the command line), we should add a template to let the confused user know not to worry about this section if they don't want to.  This is what I've come up with right now:
{{Admon/important|Advanced Usage|This content is written for the more advanced user.  It assumes that you are comfortable with the command line and have a relatively good knowledge of Linux terminology.  It is probably not necessary to using Fedora as a desktop user, but can help a desktop user expand his or her knowledge base and face more complicated troubleshooting issues.}}
That, again, is just my current idea until someone suggests or comments on that.  Let me know in IRC or on the list.
--[[User:Danielsmw|Danielsmw]] 15:08, 25 February 2009 (UTC)


{|
[[Category:Docs Project archives]]
|-
| Task || Assigned to || Status
|-
| Create new [[User_Guide]] F10 draft pages || [[User:Kwade]] || Completed
|}

Latest revision as of 01:18, 15 June 2010

Tasks currently target: Fedora 12 User Guide

Task List

The task list below has four stages:

Fact Check
This stage just changes all factual information so that it syncs up with the facts for F12. If the default browser happens to be Dillo instead of Firefox for this release, the Fact Check stage should reflect this after completion.
(Re)write Chapter
This stage is for two things: re-fact checking and then editing the formatting and organization of sections so that it lines up with all of our conventions. This could mean anything from fixing headers to putting in admons (like the ones at the bottom of this page) to making sure that the standard installation process is referenced instead of including it inline.
Edit/Wordsmith
This is for the English majors. Make the page grammatically sound while keeping our conventions and a technical writing style in mind. Extra points go for stylizing the writing as long as it doesn't conflict with the core goals of readability and simplicity in comprehension.
Edit Format/XML Conversion
Somebody get this chapter into DocBook XML!
Chapter Status Fact check (Re)write chapter Edit/wordsmith Edit format/XML conversion
User Guide - Introduction Done, provisionally Do again before XML Done (danielsmw) n/a (do this last)
User Guide - The Fedora Desktops
User Guide - Logging in Draft In progress Rewritten (danielsmw) Assign me! Not ready
User Guide - Tour of the GNOME Desktop
User Guide - Tour of the KDE Desktop
User Guide - Tour of the Xfce Desktop
User Guide - Media
User Guide - Connecting to the Internet
User Guide - Accessing the Web
User Guide - Communications
User Guide - Office Tools
User Guide - Financial Software
User Guide - Playing Multimedia
User Guide - Playing Games
User Guide - Managing Photos
User Guide - Sharing Your Desktop
User Guide - Customizing the Desktop
User Guide - Managing Software

Notes to Contributors

Application Installations

Whenever we discuss an application not installed by default, we should put a note about having to install it. The note should look like this:

Of course, this should be edited according to the application name, package name, and application home page, but try to use this template for consistency's sake.

  • Also note that I just made this convention up, so don't feel like you should have known this before. If you have suggestions or comments, let me know.

--Danielsmw 15:08, 25 February 2009 (UTC)

Advanced Topics

Whenever we add something that would be nice to have in the user's guide but isn't necessary for the basic desktop user who just migrated fresh from Windows (example: discussion of FTP programs, advanced discussion of yum on the command line), we should add a template to let the confused user know not to worry about this section if they don't want to. This is what I've come up with right now:

Advanced Usage
This content is written for the more advanced user. It assumes that you are comfortable with the command line and have a relatively good knowledge of Linux terminology. It is probably not necessary to using Fedora as a desktop user, but can help a desktop user expand his or her knowledge base and face more complicated troubleshooting issues.

That, again, is just my current idea until someone suggests or comments on that. Let me know in IRC or on the list. --Danielsmw 15:08, 25 February 2009 (UTC)