Wikieducator tutorial/RTE Tutorials

Note that this page, discussing plans and progress toward development of RTE tutorials, is a sub-page of original "wikitext" tutorials, not the main page for WikiEduator rich text editor tutorials.

General items for all RTE tutorials

 * Insert tag for all links for use when printing an off line version of the tutorials
 * Update print specific templates, using the No print category for navigation templates and Template:Foo/print for new collection extension (may need to wait until live on the AU servers.)
 * Test for print version of all tutorials.
 * With reference to all FAQ pages -- remove invite to list FAQs on the tutorial page and post a link to the main WE list and/or relevant discussion page for support questions.


 * I think it may be better to specify this as a separate statement of work / consultancy and collapse this with any other updates which may be required with the migration to the latest version of the collection extension. I don't want to guess a time estimate yet, but included this here on the to list for the future so that I don't forget --Wayne Mackintosh 04:46, 18 October 2009 (UTC)


 * I think we need to protect all the tutorial pages as these are high traffic pages and will reduce the amount of reversions needed. So I imagine the FAQ page been locked with a solution eg posting to the main list or discussion page for support related questions. There are significant improvements with the latest version of LQT. --Wayne Mackintosh 04:46, 18 October 2009 (UTC)


 * Where can a fella find out, what the improvements to LQT are? Randy Fisher 21:07, 14 February 2010 (UTC)

I am adding a   trough items once they have been actioned. Rob Kruhlak 07:03, 5 November 2009 (UTC)

Language/Terminology

 * Use of the following terms should be in lowercase when used as general improper nouns (unless referring to a specific field, button, or other screen feature, in which case format as written on the screen).
 * wiki
 * username (also, all one word)
 * password (also, all one word)
 * rich text editor
 * web site (as two words)


 * While "rich text editor" is an improper noun describing a kind of editor, "Rich Editor" is the name of WikiEducator's rich text editor, suggesting it should be capitalised.


 * Use the term "Rich Editor toolbar", with "Rich Editor" capitalised, when referring to the toolbar on the FCK editor.


 * Use of the term "Internet" should be capitalized. (Note that there is a growing argument that "Internet" is no longer a proper noun.)




 * Use "log in" when used as a verb (e.g., to log in to WikiEducator) and log-in when used as an adjective or noun (e.g., log-in account).



Within-text formatting

 * Italicise the names of screen features, e.g., menus, tools, fields, and dialog boxes), making sure to type the name exactly as displayed in the application, e.g., The Link dialog box.
 * Put quotes around text phrases, whether as viewed on the screen or to be entered via the keyboard, e.g., "Learning4Content" is the page name....
 * Bold names which are used in actions or commands, e.g., "Click on the Insert/Edit Link button...."
 * Bold names which are used in actions or commands, e.g., "Click on the Insert/Edit Link button...."


 * Hi Alison -- the FA template is redundant if the image page uses the Metadata template. Image attribution is messy in WE --- something we need to tidy up. Personally I have a preference for using the Metadata template on the image page -- in this way we remain consistent with where the Wikimedia Commons publish licensing information. --Wayne Mackintosh 02:05, 28 February 2010 (UTC)
 * I agree. It's redundant (and in my opinion detracts from the caption). I'll remove the template from the two images that I added it to, and put on my list of things to check, that all of the images include the metadata template. Thanks for your thoughts on this. --Alison Snieckus 02:29, 28 February 2010 (UTC)


 * Include a caption describing an image, or its relevance to the content. Images should include attribution (using Template:Metadata) on the image page; attribution statements are not displayed on the image when included on a page.

Project set-up and multimedia development

 * Setting up pages and creating navigation templates for each tutorial. 8 hours
 * Reworking / creating 12 screen cast videos. 8 hours

Total time for project: 6 FTE days

Tutorial 1: What is a wiki
Estimated time for revision: 2 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 1
 * Home page
 * Review and update any links
 * Advantages and disadvantages
 * &lt;strike&gt;Review and update any links
 * About WikiEducator
 * Review and update links for better examples now available in the wiki
 * Summary and FAQs
 * Review and add any FAQs based on our experience from Learning4Content
 * Final language edit.



Tutorial 2: Creating an account
Estimated time for revision: 3 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 2
 * Home page
 * Wayne to create updated slideshow for WE
 * Wayne to update audio recording --- remove references to COL & update for OERF


 * Benefits
 * No updates anticipated -- copy over to new page
 * Detailed Instructions
 * Update screen shot for new captcha extension
 * Update links to new screencast videos
 * Review for any further updates
 * Added a direct link to the Create account page in activity 1. Rob Kruhlak 05:57, 12 December 2009 (UTC)




 * Show_me_how
 * Create new screen cast (for use with new captcha utility)
 * Split the login / create new account part from the screen filling in personal details so that we have two screencasts to match the activity links on the Detailed instructions page.
 * Summary and FAQs
 * Wayne to update this FAQ re OERF
 * Add a few FAQs relating to setting user preferences
 * Check with Jim re our planned implementation of RTE defaults for enabling the RTE editor.
 * Final language edit.
 * Final language edit.

Tutorial 3: Editing basics
Estimated time: 3 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 3
 * Home page
 * Ask Brent to update audio file (i.e. remove reference to COL)
 * Update page for RTE (i.e. remove reference to raw wiki text)
 * Edit mode
 * Add paragraph or subsection with reference to RTE
 * Review content for any updates required
 * Update page for RTE (i.e. remove reference to raw wiki text)
 * Add screen shot of edit view using RTE -- Added screenshots of wikitext, rich text toolbars.
 * Remove cheatsheet activity -- no longer necessary.
 * May need a screenshot of the RTE edit mode. Rob Kruhlak 06:35, 5 December 2009 (UTC)
 * Probably need to describe how to get to Rich editor mode as I think wikitext is the default. Rob Kruhlak 06:35, 5 December 2009 (UTC)
 * I think we need to add a section on the wikitext mode as well as the rich editor mode so that we can refer back to it from the later tutorials. I already have some links to a section heading called ==Wikitext_mode== . The advantage (or disadvantage if you make a mistake) to using the wikitext mode as compared to disabling the rich editor is that once you preview you are back in the rich editor. Rob Kruhlak 06:35, 5 December 2009 (UTC)
 * First edit
 * Review for any changes for RTE
 * Wikieducator_rich_text_editor_tutorials/Editing_basics/Edit_mode#Wikitext_mode (Heading is Wikitext editing). Need to update tutorials (6-10) Rob Kruhlak 08:46, 2 February 2010 (UTC)
 * Do we need a screen shot?
 * Show me how
 * Create new screencast using RTE
 * Summary and FAQs
 * Review summary
 * Add a few relevant FAQs based on our experiences of Learning4Content
 * Could be very different problems (ie getting to rich text mode). Have removed FAQs to start from a clean slate. Rob Kruhlak 08:46, 2 February 2010 (UTC)
 * Final language edit.

Tutorial 4: Basic Text Formatting
Estimated time: 4 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 4
 * Home page
 * Update subsection for RTE


 * Creating a sandbox
 * Will need steps for inserting a new subpage plus screen shots of the new page pop-up window used by the FCK editor
 * Consider an input box solution or some automation for setting up a sandbox -- Chat with Jim about a default set up for new user pages (eg including a default welcome message template, inserting the sandbox and personal userbox.
 * Added an input box for creating a sandbox subpage linked from user page. Rob Kruhlak 07:52, 4 February 2010 (UTC)




 * Bold, italics and headings
 * Develop new page using RTE
 * Incorporate screen shot with labels showing different buttons for the relevant text formatting features
 * Bullets and numbered lists
 * Develop new page based using RTE
 * Incorporate screen shot with labels showing different buttons for the relevant text formatting features
 * New screencast needed for (1)
 * New screencast needed for (2)
 * New screencast needed for (3)
 * Summary and FAQs
 * Update and revise summary for RTE -- started on this Rob Kruhlak 07:52, 4 February 2010 (UTC)
 * Insert FAQs based on our experiences of Learning4Content




 * Final language edit.


 * That's a good idea -- we can tweak this a little with an input box embedded in the tutorial where the default is "User:" -- something like Create an institutional OER portal page --Wayne Mackintosh 23:38, 21 October 2009 (UTC)

Tutorial 5: New pages and links
Estimated time: 4 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 5
 * Recommend new order for this tutorial -- cover external links before doing internal links


 * Consider whether it is better to teach links to existing internal links before covering new pages


 * Home page
 * Need an introduction section introducing two types of links
 * New pages and links
 * See comment about sequencing above moved after internal links and before interwiki links Rob Kruhlak 07:52, 5 February 2010 (UTC)
 * Review and update page for RTE
 * Consider removing the reference to creating new pages from the url -- not ideal for newbies. Suggest moving this feature to the FAQ section.
 * Incorporate screenshot with labels for the new RTE interface
 * Internal links
 * moved before new pages Rob Kruhlak 07:52, 5 February 2010 (UTC)
 * Interwiki links
 * See comment about sequencing above
 * Review and update page for RTE
 * Incorporate screenshot with labels for the new RTE interface
 * External links
 * See comment about sequencing above moved to after intro Rob Kruhlak 07:52, 5 February 2010 (UTC)
 * Review and update page for RTE
 * Consider using a better subheading structure for the different types of external links, eg Footnote, direct link, pipes
 * Incorporate screenshot(s) with labels for the new RTE interface
 * Screencast
 * Create new screencast using RTE Created one for internal links. Do we want one for external links or new pages? Rob Kruhlak 08:04, 13 February 2010 (UTC)
 * Summary & FAQs


 * Review and update the FAQs based on our experiences of Learning4Content
 * Final language edit.

Tutorial 6: Images and Media
Estimated time: 5 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 6
 * Include a new subpage on licensing of images and where to find free images and how to search for free content images (we can only use GFDL, CC-BY, CC-BY-SA &amp; PD images). Cover feature pulling images in from the wiki commons.
 * Home page
 * Insert short paragraph referencing free content licensing of images
 * Wayne: Try and source an audio recording from someone to talk about free images (perhaps someone from CC)
 * Added new subpage on permissible images and where to find them. Could be moved to introduction but would make it long. Could move some of it ...
 * Basics
 * Review and update page for RTE
 * Incorporate screenshot(s) with labels for the new RTE interface
 * Frames and Thumbnails
 * Review and update page for RTE
 * Incorporate screenshot(s) with labels for the new RTE interface
 * Other media
 * Review and update page for RTE
 * Incorporate screenshot(s) with labels for the new RTE interface
 * Add subsection for feature -- as optional section -- consider new subpage in this tutorial for more advanced media.
 * Add subsection for feature consider new subpage in this tutorial for more advanced media.
 * Screencast
 * Create new screencast using RTE
 * Tips
 * Review and update tips page.
 * Include subsection on alternative to use
 * Review and update tips page.
 * Include subsection on alternative to use

-- note that templates have not been covered yet, so we need to link to the tutorial with a note saying templates are covered later. Still need to verify the link to template tutorial. Rob Kruhlak 06:35, 5 December 2009 (UTC)
 * FAQs
 * Review and update FAQs based on our experiences with Learning4Content
 * Final language edit.


 * I think that's a sensible split --- we must just keep the generic format with an intro on the tutorial's landing page. --Wayne Mackintosh 23:39, 21 October 2009 (UTC)

Tutorial 7: Collaborative Editing
Estimated time: 3 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 7
 * Home page
 * Review content
 * Need better introduction --- This is a tutorial about tools and features for monitoring collaborative editing and tracking edits in the wiki. Need to introduce learners to the features that will be covered in the tutorial.
 * Recent changes
 * Review text
 * Insert screenshot of where to find the recent changes link
 * Insert screenshot of the recent changes page with a few labels showing most useful elements on the recent changes page
 * Diff and History
 * Review -- no major changes anticipated
 * Reverting
 * Review -- no major changes anticipated
 * Screen cast
 * Existing screen cast looking at the Diff is fine
 * Need a new sceencast for demonstrating a revert -- with the RTE interface for saving the revision.
 * Summary and FAQs
 * Review page
 * Insert new FAQs based on our experiences of Learning4Content
 * Remove comments which are better suited to the talk page rather than the tutorial itself -- also WE is different from WP insofar as NPOV is concerned -- we're not developing encyclopaedia articles.
 * Final language edit.
 * Final language edit.

Tutorial 8: Communication and interaction
Estimated time: 1 hour


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 8
 * Leave pages regarding Discussion pages for the time being --- until we get latest versions of LQT installed and sorted.
 * Talk pages
 * Leave for the time being.
 * Useful feature
 * Review and update page
 * Do we need to add any other useful features?
 * Screencast
 * Screencast is fine -- but add alternative method of adding page to a Watchlist by clicking the radio button before saving in edit view. Use the RTE edit window for this screencast edition.
 * Alternate adding to watchlist screen movie created and uploaded. New page for screen movie created and navigation updated. Rob Kruhlak 21:19, 15 February 2010 (UTC)
 * Final language edit (for pages updated).

Tutorial 9: Pedagogical Templates
Estimated time: 3 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 9
 * Home page
 * Review and update page
 * Consider replacing image with a screenshot illustrating Pedagogical Templates on a page
 * Template syntax
 * Review and update for inserting template syntax using RTE
 * Incorporate screen shots for how templates are displayed in the editing view and a label for the template icon in the RTE.
 * Include link to pdf cheatsheet for pedagogical templates
 * Examples
 * Review and update examples page for use with RTE
 * Add new subsection for Customisations of templates, eg alternate titles, inserting template in TOC etc.
 * Check for functionality of print versions of these template features -- currently breaking during rendering when using these additional parameters.
 * Screencast
 * Create new screencast using RTE for inserting template syntax.
 * Summary and FAQs
 * Review and update FAQs


 * Final language edit.


 * Agreed -- lets drop this for the current iteration. We can tackle this at a later date. --Wayne Mackintosh 23:40, 21 October 2009 (UTC)

Tutorial 10: Thinking about structure
Estimated Time: 4 hours


 * Create new navigation template for the RTE tutorial version
 * Create new pages for RTE version of tutorial 9
 * Home page
 * Review page
 * Create links to Tutorial on Navigation templates.
 * Subpages
 * Review and update page for using with RTE
 * Incorporate screenshot with labels
 * Navigation templates
 * Suggest removing this subsection from this tutorial --- embed an appropriate reference and link on the Subpages page. Skills required for navigation templates are too advanced for this level of tutorial. We'll shift this over to the intermediate level tutorials.


 * Categories
 * Review in the light of the styles workgroup and progress on Categories
 * Update section for inserting categories using the RTE
 * We will need a more detailed tutorial to be developed for Categories. The page in this tutorial should be an introduction.
 * Summary and FAQs
 * Review and update
 * Insert FAQs based on our experience of L4C.
 * Create screencast showing how to create a subpage using RTE and insert a subpage for the movie.
 * Final language edit.