Todo

Differences between revisions 2 and 3
Revision 2 as of 2010-09-12 02:22:34
Size: 2723
Editor: 112
Comment:
Revision 3 as of 2010-09-13 06:59:30
Size: 11571
Editor: adsl-242-246-22
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== Developers' ToDo List ==
This is the current list of tasks for the Ubuntu Tour Developers:

 *Devise a format for storing 'tours' so they can be opened by the application
  *These should be stored in some kind of archive (.tar?), so a user can just download a single file and load it up in the app
  *This archive should include all resources (images, text) needed
  *'tours' should not be 'built-in' to the app. The app should open & interpret them from these files
 *The app needs several methods for determining when a step of a certain tour is complete. This can include things like:
  *Process detection
  *DBus
  *A 'next' button (with indicator on whether automatic or manual)
 *The app needs to indicate to users on the screen a certain location of interest. We need some way of rendering arrows or boxes on the screen (outside of the main app window) to highlight things.
 *UI design
  *The html view, now uses css colours read from the gtkrc theme

== Writers' ToDo List ==
These are the topics we hope to include in the tour. Note that there may already be content for some of these topics. To check, please refer to the [[https://code.launchpad.net/~ubuntu-tour/ubuntu-tour/maverick|stable launchpad bzr branch]].
 *About Ubuntu/Welcome
  *What is Ubuntu?
  *Applications Menu
  *Places Menu
  *System Menu
  *Other top panel items
  *Desktop
  *Window management
  *Workspaces
= Writing Section =
== Pages List: ==

 *About Ubuntu/Welcome -done


  *What Ubuntu is - done


  *Applications Menu - done


  *Places Menu - done

  *System Menu - done

  *Other top panel items - done

  *Window management - done

  *Workspaces - done
Line 28: Line 24:
 *Networks
  *Network applet
  *Wireless (if applicable)
 *Firefox
  *How to launch it
  *URLs/search bar

 *Networks - done

  *Network applet, what internet is - done

  *Wireless (if applicable) - done

  *Wired - done

  *VPN - done

  *DSL - done

  *Mobile Broadband ?

 *Firefox - done

  *How to launch it-done

  *URLs/search bar-done

  *Navigation-done

 *Media Player - done

  *How to launch it - done

  *Using it - done

  *Codecs

 *Empathy - done

  *What it is - done

  *Setup (old account) - done

  *Setup (new account) - done

  *Setup (People Nearby) - done

  *Contacts list - done

  *Chat window - done

  *Desktop intergration - done

 *OpenOffice

  *What it can do, how to launch it

  *(A brief tutorial on the user's choice of Writer/Impress/Spreadsheet.) -## Is this needed?

  *Formats and compatability

 *File Manager - done

  *Basics of files and folders - done

  *Moving/copying/renaming - done

  *Properties dialog - done

 *Photo and images (I don't know if include or not EOG..)

  *What's Shotwell? (for beginners who never saw a photo manager)

  *How to import photos from your camera

  *How to add tags and sort events

  *Edit a photo (little explanation of what buttons do)

  *Share a photo

 *Scan an image (random: I'm working with shotwell, if you want to write this section for me you're welcome!)

  *Simple guide to Simple scan

  *Multiple scan

 *Desktop Customization - done

  *Launch it

  *Themes - done

  *Backgrounds - done

  *Fonts - done

  *Visual effects

 *Software Management

  *What the Software Centre is and how to launch it
Line 35: Line 122:
 *Media Player
  *How to launch it
  *Using it
  *Codecs
 *Empathy
  *What it is
  *Setup (old account)
  *Setup (new account)
  *Setup (People Nearby)
  *Contacts list
  *Chat window
  *Desktop intergration
 *OpenOffice
  *What it can do, how to launch it
  *Formats and compatability
 *File Manager
  *Basics of files and folders
  *Moving/copying/renaming
  *Properties dialog
 *Photo and images
  *What's Shotwell? (for beginners who never saw a photo manager)
  *How to import photos from your camera
  *How to add tags and sort events
  *Edit a photo (little explanation of what buttons do)
  *Share a photo
 *Scan an image
  *Simple guide to Simple scan
  *Multiple scan
 *Desktop Customization
  *Launch it
  *Themes
  *Backgrounds
  *Fonts
  *Visual effects
 *Software Management
  *What the Software Centre is and how to launch it
  *Navigation
Line 73: Line 124:
Line 74: Line 126:
Line 75: Line 128:
  *Paid apps
*Paid-apps
Line 77: Line 132:
Line 78: Line 134:
Line 79: Line 136:
Line 80: Line 138:
Line 81: Line 140:
Line 82: Line 142:
Line 83: Line 144:
Line 84: Line 146:

== Additional stuff: ==

'Did you know?' section (mentioning that users can make Desktop (or panel) shortcuts through dragging or the Right-Click menu.)

== 'Not to skip' list ==

1 - Some simple but useful terminal commands are a must





= Graphics/Design TODO: =

Format: Section of the tour (screenshot)

'''1. UI Mockups'''

'''2. Screenshots:'''

Every item from the pages list:


  *Ubuntu Intro (Screenshots):
  
   *Applications Menu (Main Menu) (gnome-panel -> main-menu open)

   *Places Menu (Places Menu) (gnome-panel -> places open)

   *System Menu (System Menu) (gnome-panel -> system open)

   *Other top panel items (gnome-panel with running apps)

   *Window management (Window control buttons)

   *Workspaces (gnome-panel > workspaces applet)

   *Trash (gnome-panel > trash icon)

  *Networks (System>Preferences>Network Connections):
  
   *Network applet (gnome-panel > network applet; Open and closed, and "Edit connections" menu)

   *Wireless (gnome-panel - Closed > "wireless connected" icon, gnome-panel > network applet - Open, and "Edit connections" wireless menu)

   *Wired (gnome-panel > network applet - Open, and "Edit connections > Wired)

   *VPN (gnome-panel > network applet - Open, and "Edit connections > VPN)

   *DSL (gnome-panel > network applet - Open, and "Edit connections > DSL)

   *Mobile Broadband ?

  *Firefox (Screenshots):
  *How to launch it (Applications > Internet > Firefox, and gnome-panel applet)

   *URLs/search bar (Firefox > URL bar, and Firefox > Search bar)

   *Navigation (Firefox > Navigation icons)

  *Media Player (Gnome-panel > volume applet > Rhythmbox, and gnome-panel-> Applications > Sound and Video > Rhythmbox):
  *How to launch it (screenshot:)

   *Using it (Rhythmbox -> Media control buttons, Rhythmbox -> Left panel)

   *Codecs (Rhythmbox -> "Add non-free codecs" message window)

  *Empathy (Screenshots):
   *What it is (logo + main window?)

   *Setup (old account) (Accounts -> Manage Accounts (ctrl+a))

   *Setup (new account) (see above, click Add...)

   *Setup (People Nearby) (screenshot:)

   *Contacts list (login on a dummy account, contacts)

   *Chat window (Empathy -> Chat window)

   *Desktop intergration (gnome-panel -> notifications icon -> Broadcast )

  *OpenOffice (Screenshots):
   *What it can do, how to launch it (screenshot:)

   *(A brief tutorial on the user's choice of Writer/Impress/Spreadsheet.) -## Is this needed? (screenshot:)

   *Formats and compatability (this should probably have an image of different file formats, ie a ms doc, open office, pdf)

  *File Manager (Screenshots):
   *Basics of files and folders (~ launched in nautilus)

   *Moving/copying/renaming (nautilus -> right click menu -> move-to/delete/copy, nautilus -> image of "drag'n'drop" cursor icons (shift/control/alt)

   *Properties dialog (nautilus -> right click menu (?) + properties dialog)

  *Photo and images (gnome-panel -> applications -> graphics -> Shotwell / Image viewer):
   *Eye of Gnome (Eye of Gnome image viewer )

   *Shotwell? (Shotwell - Intro screen, Shotwell - Main view screenshot)

   *How to import photos from your camera (Shotwell -> Import, Nautilus -> popup menu for "import photos")

   *How to add tags and sort events (Shotwell -> tags menu, shotwell -> right-click -> tag photos (? - or alternate method, if exist) )

   *Edit a photo (Nautilus -> "edit photos" menubar, Nautilus -> right click -> Open with ... -> GIMP / Shotwell)

   *Share a photo (? Unknown?)

  *Scan an image (Screenshots):
   *Simple scan (screenshot:)

   *Multiple scan (screenshot:)

  *Desktop Customization (Screenshots):
   *Launch it (main menu again)

   *Themes (appearances -> themes)

   *Backgrounds (appearances -> background)

   *Fonts (appearances -> fonts)

   *Visual effects (main window + compiz settings manager? (but not installed by default)

  *Software Management (Screenshots):
   *What the Software Centre is and how to launch it (gnome main menu)

   *Navigation (main window with emphasis on the right part, icons OR a list of the apps from any categories)

   *Installation (dummy package) (Dummy package window cursor on the "Install" button)

   *Removal (dummy package) (1. List of all installed apps, with dummy app selected and mouse cursor on "Uninstall" button, or 2. Window of the actual package with cursos or "Uninstall")

   *History

   *Paid-apps

   *Updates (whats and whys) (System -> Administration -> Update Manager -- maybe the update tray icon also?)

   *How to install updates and how to configure settings

  *Getting Help (Screenshots):
   *Help Center (F1 - Main Help Center window)

   *Wiki (Is a screenshot required for this?)

   *Ubuntu Forums (See above)

   *Ubuntu Manual (See above)

   *Launchpad (bugs) (See above)


= Programming TODO: =


  *Devise a format for storing 'tours' so they can be opened by the application

   *These should be stored in some kind of archive (.tar?), so a user can just download a single file and load it up in the app

   *This archive should include all resources (images, text) needed

   *'tours' should not be 'built-in' to the app. The app should open & interpret them from these files

  *The app needs several methods for determining when a step of a certain tour is complete. This can include things like:

   *Process detection

   *DBus <- I don't know how useful DBus will be, because apps would need to be patched.

   *some apps have dbus support already. If its there, we can use it.

  *Simply the user clicking a 'next' button <- We ought to have some sort of indicator as to which it is (automagic or manual).

  *The app needs to indicate to users on the screen a certain location of interest. We need some way of rendering arrows or boxes on the screen (outside of the main app window) to hilight things.

   *we need a way to find the proper place on the screen to render the arrow/box/whatever

   *One way is to use Compiz (they have a python binding)

  *UI design

   *The html view, now uses css colours read from the gtkrc theme

= Notes: =

 *All initial topics should be intended for beginners (tour to be made extensible so anybody can create other more advanced tutorials). I like the idea of maybe linking sections to more advanced material, like a manual page, screencast, etc.


  *I think everything we provide should be considered for 'beginners'. However like I said in the chat, it we make the app extensible ok :) I think that's the intention of the screencasts.ubuntu.com .. but it could be beter organized for things liek what your talking about.

 *Include everything they need, without regard to "free"-ness. Though free is certainly preferred, keeping information away because it's not "free" is a turn-off for people. As long as we have a little disclaimer ;) The commercial side of Ubuntu cannot advocate non-free things, but the community, lets face it, they get Ubuntu or Linux in any flavor to circumvent certain things. Each has their own reasons for going to ubuntu, I just like it cuz it works !! Well, now that I think about it, it might not be that much taboo anymore, with the inclusion of paid apps in the Software Cent(re|er)
 *Each section will contain an overview and have the option to skip all of that section, or leap to specific pages. Make the important sections ask for comfimation to skip (skip/don't skip/come back later). Note that size is likely to cause multiple pages in some cases. I was thinking about making the size fixed (like the install slideshow) to prevent the need for scrolling. I hope to make about 3/4s of the expected clicking unnecessary, so we don't want to require scrolling. Thoughts?

== Other Notes ==
Also, for the browser, I'd like to see it cover more than one browser, even if only Firefox/Chrome, and have it autodetermine/ask what one to show. (It could check what the default browser is)

== Programas / temas a incluir: ==

0) Algumas informações sobre Ubuntu

1) Conectar a uma rede

2) Abra o navegador e visitar uma página web (ubuntu.com / comunidade?)

3) Abra um tocador de mídia, mídia de importação e jogar uma canção, (usando o Media Player para música) organização e definir o usuário com Ubuntu One

4) permite ao usuário adicionar uma conta através Gwibber / Empatia

5) Instalar software e atualizar o software (via centro de software do Ubuntu, adicionando um PPA e um pacote deb) (podemos permitir que o usuário instale um pacote fictício). Apenas mostrar os administradores deste.

6) Que o usuário faça a sua primeiro documento no OpenOffice

7) Personalizando o desktop (temas, fontes, wallpapers, etc)

8) mostra o usuário como obter ajuda (Launchpad, Wiki, ubuntuforums, UMP, etc)

9) Addressing problemas de driver (talvez fazer drivers perto do começo. Algo como drivers wireless não seria bom para trabalhar sem.)

10) Utilizando o gerenciador de arquivos

11) Gerenciamento de configurações (aparência, teclado, tela de login e etc)

12) Teste Ubuntu (Execute o aplicativo de teste do sistema para verificar se tudo funciona ok)

Writing Section

Pages List:

  • About Ubuntu/Welcome -done
    • What Ubuntu is - done
    • Applications Menu - done
    • Places Menu - done
    • System Menu - done
    • Other top panel items - done
    • Window management - done
    • Workspaces - done
    • Trash
  • Networks - done
    • Network applet, what internet is - done
    • Wireless (if applicable) - done
    • Wired - done
    • VPN - done
    • DSL - done
    • Mobile Broadband ?
  • Firefox - done
    • How to launch it-done
    • URLs/search bar-done
    • Navigation-done
  • Media Player - done
    • How to launch it - done
    • Using it - done
    • Codecs
  • Empathy - done
    • What it is - done
    • Setup (old account) - done
    • Setup (new account) - done
    • Setup (People Nearby) - done
    • Contacts list - done
    • Chat window - done
    • Desktop intergration - done
  • OpenOffice

    • What it can do, how to launch it
    • (A brief tutorial on the user's choice of Writer/Impress/Spreadsheet.) -## Is this needed?
    • Formats and compatability
  • File Manager - done
    • Basics of files and folders - done
    • Moving/copying/renaming - done
    • Properties dialog - done
  • Photo and images (I don't know if include or not EOG..)
    • What's Shotwell? (for beginners who never saw a photo manager)
    • How to import photos from your camera
    • How to add tags and sort events
    • Edit a photo (little explanation of what buttons do)
    • Share a photo
  • Scan an image (random: I'm working with shotwell, if you want to write this section for me you're welcome!)
    • Simple guide to Simple scan
    • Multiple scan
  • Desktop Customization - done
    • Launch it
    • Themes - done
    • Backgrounds - done
    • Fonts - done
    • Visual effects
  • Software Management
    • What the Software Centre is and how to launch it
    • Navigation
    • Installation (dummy package)
    • Removal (dummy package)
    • History
    • Paid-apps
    • Updates (whats and whys)
    • How to install updates and how to configure settings
  • Getting Help
    • Help Center
    • Wiki
    • Ubuntu Forums
    • Ubuntu Manual
    • Launchpad (bugs)

Additional stuff:

'Did you know?' section (mentioning that users can make Desktop (or panel) shortcuts through dragging or the Right-Click menu.)

'Not to skip' list

1 - Some simple but useful terminal commands are a must

Graphics/Design TODO:

Format: Section of the tour (screenshot)

1. UI Mockups

2. Screenshots:

Every item from the pages list:

  • Ubuntu Intro (Screenshots):
    • Applications Menu (Main Menu) (gnome-panel -> main-menu open)

    • Places Menu (Places Menu) (gnome-panel -> places open)

    • System Menu (System Menu) (gnome-panel -> system open)

    • Other top panel items (gnome-panel with running apps)
    • Window management (Window control buttons)
    • Workspaces (gnome-panel > workspaces applet)

    • Trash (gnome-panel > trash icon)

  • Networks (System>Preferences>Network Connections):

    • Network applet (gnome-panel > network applet; Open and closed, and "Edit connections" menu)

    • Wireless (gnome-panel - Closed > "wireless connected" icon, gnome-panel > network applet - Open, and "Edit connections" wireless menu)

    • Wired (gnome-panel > network applet - Open, and "Edit connections > Wired)

    • VPN (gnome-panel > network applet - Open, and "Edit connections > VPN)

    • DSL (gnome-panel > network applet - Open, and "Edit connections > DSL)

    • Mobile Broadband ?
  • Firefox (Screenshots):
  • How to launch it (Applications > Internet > Firefox, and gnome-panel applet)

    • URLs/search bar (Firefox > URL bar, and Firefox > Search bar)

    • Navigation (Firefox > Navigation icons)

  • Media Player (Gnome-panel > volume applet > Rhythmbox, and gnome-panel-> Applications > Sound and Video > Rhythmbox):

  • How to launch it (screenshot:)
    • Using it (Rhythmbox -> Media control buttons, Rhythmbox -> Left panel)

    • Codecs (Rhythmbox -> "Add non-free codecs" message window)

  • Empathy (Screenshots):
    • What it is (logo + main window?)
    • Setup (old account) (Accounts -> Manage Accounts (ctrl+a))

    • Setup (new account) (see above, click Add...)
    • Setup (People Nearby) (screenshot:)
    • Contacts list (login on a dummy account, contacts)
    • Chat window (Empathy -> Chat window)

    • Desktop intergration (gnome-panel -> notifications icon -> Broadcast )

  • OpenOffice (Screenshots):

    • What it can do, how to launch it (screenshot:)
    • (A brief tutorial on the user's choice of Writer/Impress/Spreadsheet.) -## Is this needed? (screenshot:)
    • Formats and compatability (this should probably have an image of different file formats, ie a ms doc, open office, pdf)
  • File Manager (Screenshots):
    • Basics of files and folders (~ launched in nautilus)
    • Moving/copying/renaming (nautilus -> right click menu -> move-to/delete/copy, nautilus -> image of "drag'n'drop" cursor icons (shift/control/alt)

    • Properties dialog (nautilus -> right click menu (?) + properties dialog)

  • Photo and images (gnome-panel -> applications -> graphics -> Shotwell / Image viewer):

    • Eye of Gnome (Eye of Gnome image viewer )
    • Shotwell? (Shotwell - Intro screen, Shotwell - Main view screenshot)
    • How to import photos from your camera (Shotwell -> Import, Nautilus -> popup menu for "import photos")

    • How to add tags and sort events (Shotwell -> tags menu, shotwell -> right-click -> tag photos (? - or alternate method, if exist) )

    • Edit a photo (Nautilus -> "edit photos" menubar, Nautilus -> right click -> Open with ... -> GIMP / Shotwell)

    • Share a photo (? Unknown?)
  • Scan an image (Screenshots):
    • Simple scan (screenshot:)
    • Multiple scan (screenshot:)
  • Desktop Customization (Screenshots):
    • Launch it (main menu again)
    • Themes (appearances -> themes)

    • Backgrounds (appearances -> background)

    • Fonts (appearances -> fonts)

    • Visual effects (main window + compiz settings manager? (but not installed by default)
  • Software Management (Screenshots):
    • What the Software Centre is and how to launch it (gnome main menu)
    • Navigation (main window with emphasis on the right part, icons OR a list of the apps from any categories)
    • Installation (dummy package) (Dummy package window cursor on the "Install" button)
    • Removal (dummy package) (1. List of all installed apps, with dummy app selected and mouse cursor on "Uninstall" button, or 2. Window of the actual package with cursos or "Uninstall")
    • History
    • Paid-apps
    • Updates (whats and whys) (System -> Administration -> Update Manager -- maybe the update tray icon also?)

    • How to install updates and how to configure settings
  • Getting Help (Screenshots):
    • Help Center (F1 - Main Help Center window)
    • Wiki (Is a screenshot required for this?)
    • Ubuntu Forums (See above)
    • Ubuntu Manual (See above)
    • Launchpad (bugs) (See above)

Programming TODO:

  • Devise a format for storing 'tours' so they can be opened by the application
    • These should be stored in some kind of archive (.tar?), so a user can just download a single file and load it up in the app
    • This archive should include all resources (images, text) needed
    • 'tours' should not be 'built-in' to the app. The app should open & interpret them from these files

  • The app needs several methods for determining when a step of a certain tour is complete. This can include things like:
    • Process detection
    • DBus <- I don't know how useful DBus will be, because apps would need to be patched.

    • some apps have dbus support already. If its there, we can use it.
  • Simply the user clicking a 'next' button <- We ought to have some sort of indicator as to which it is (automagic or manual).

  • The app needs to indicate to users on the screen a certain location of interest. We need some way of rendering arrows or boxes on the screen (outside of the main app window) to hilight things.
    • we need a way to find the proper place on the screen to render the arrow/box/whatever
    • One way is to use Compiz (they have a python binding)
  • UI design
    • The html view, now uses css colours read from the gtkrc theme

Notes:

  • All initial topics should be intended for beginners (tour to be made extensible so anybody can create other more advanced tutorials). I like the idea of maybe linking sections to more advanced material, like a manual page, screencast, etc.
    • I think everything we provide should be considered for 'beginners'. However like I said in the chat, it we make the app extensible ok Smile :) I think that's the intention of the screencasts.ubuntu.com .. but it could be beter organized for things liek what your talking about.

  • Include everything they need, without regard to "free"-ness. Though free is certainly preferred, keeping information away because it's not "free" is a turn-off for people. As long as we have a little disclaimer Wink ;) The commercial side of Ubuntu cannot advocate non-free things, but the community, lets face it, they get Ubuntu or Linux in any flavor to circumvent certain things. Each has their own reasons for going to ubuntu, I just like it cuz it works !! Well, now that I think about it, it might not be that much taboo anymore, with the inclusion of paid apps in the Software Cent(re|er)

  • Each section will contain an overview and have the option to skip all of that section, or leap to specific pages. Make the important sections ask for comfimation to skip (skip/don't skip/come back later). Note that size is likely to cause multiple pages in some cases. I was thinking about making the size fixed (like the install slideshow) to prevent the need for scrolling. I hope to make about 3/4s of the expected clicking unnecessary, so we don't want to require scrolling. Thoughts?

Other Notes

Also, for the browser, I'd like to see it cover more than one browser, even if only Firefox/Chrome, and have it autodetermine/ask what one to show. (It could check what the default browser is)

Programas / temas a incluir:

0) Algumas informações sobre Ubuntu

1) Conectar a uma rede

2) Abra o navegador e visitar uma página web (ubuntu.com / comunidade?)

3) Abra um tocador de mídia, mídia de importação e jogar uma canção, (usando o Media Player para música) organização e definir o usuário com Ubuntu One

4) permite ao usuário adicionar uma conta através Gwibber / Empatia

5) Instalar software e atualizar o software (via centro de software do Ubuntu, adicionando um PPA e um pacote deb) (podemos permitir que o usuário instale um pacote fictício). Apenas mostrar os administradores deste.

6) Que o usuário faça a sua primeiro documento no OpenOffice

7) Personalizando o desktop (temas, fontes, wallpapers, etc)

8) mostra o usuário como obter ajuda (Launchpad, Wiki, ubuntuforums, UMP, etc)

9) Addressing problemas de driver (talvez fazer drivers perto do começo. Algo como drivers wireless não seria bom para trabalhar sem.)

10) Utilizando o gerenciador de arquivos

11) Gerenciamento de configurações (aparência, teclado, tela de login e etc)

12) Teste Ubuntu (Execute o aplicativo de teste do sistema para verificar se tudo funciona ok)

UbuntuTour/Todo (last edited 2011-02-13 12:55:24 by 541B44C8)