Join our WikiEducator discussion group or Register now for free skills training.

Wikieducator tutorial/RTE Tutorials

From WikiEducator

Jump to: navigation, search

Contents

General items for all RTE tutorials

  • Insert <ref> 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.

(image:comment.gif: Do you have an estimate for the number of hours the general items will take? The print version of the templates could eat up a fair amount of time depending on how different the pdf extension is. I tried to do some tests but the AU wiki is located for a database update.)

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)

(image:comment.gif: Another possibility for the FAQs page could be to have the summary/content in a template (which would be locked) and the FAQs page open for editing. This keeps the FAQs in the wiki and would allow users to edit freely (maybe even reduce the amount of reversions)? )

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)


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


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

(image:comment.gif: Have added link to main FAQs page but maybe more FAQs as we work through - Helena)

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
  • 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.

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)
    • 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
    • Remove cheatsheet activity -- no longer necessary.
  • First edit
    • Review for any changes for RTE
    • 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
  • 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.
  • 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
    • Insert FAQs based on our experiences of Learning4Content
  • Final language edit.

(image:comment.gif: With regards to automating the sandbox creation, I have set up this template to be used via substitution for Gladys (eL4C31) to make it easier to populate her participants user pages. It includes a link to a sandbox, a personal infobox as well as a welcome message. It should be good for other L4C workshops and the section on creating a sandbox could be replaced with a link to the sandbox?)

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

(image:comment.gif: I think this is a good idea. Rob Kruhlak 07:29, 8 November 2009 (UTC))

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

(image:comment.gif: This is probably a good idea also.Rob Kruhlak 07:29, 8 November 2009 (UTC))

  • Home page
  • Need an introduction section introducing two types of links
  • New pages and links
    • See comment about sequencing above
    • 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
  • Interwiki links (image:comment.gif: Added this page to the original tutorial based on feedback on tutorial FAQ page. Will need to be tweaked for RTE version but the sequence should be okay. Rob Kruhlak 07:29, 8 November 2009 (UTC))
    • 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
    • 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
  • 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 & 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)
  • 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 <playmp3> feature -- as optional section -- consider new subpage in this tutorial for more advanced media
    • Add subsection for <flash> 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 {{Clear}} -- note that templates have not been covered yet, so we need to link to the tutorial with a note saying templates are covered later.
  • FAQs
  • Final language edit.

(image:comment.gif: I split the Image and Media tutorial for a workshop I ran in July. The images and media tutorials were put together at the last minute. In the media tutorial there are subpages for flash and audio that could be used as a starting point for the RTE versions. Let me know if you think this might be a useful way to go.)

(image:comment.gif: Add a subsection on embedding MediaWiki commons images using the "local" image syntax?)

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.

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.
  • 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 (image:comment.gif: Helena, can you update the text in the Media template and possibly the audio?)
    • 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.

(image:comment.gif: Functionality check could be time consuming if things have gone off track in the new version of the pdf extension. See note in general items section.)

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.
Retrieved from "http://www.wikieducator.org/Wikieducator_tutorial/RTE_Tutorials"