Guidance for teachers

From Higher Computing Science
Jump to: navigation, search

Guide for Teachers

To contribute to this wiki should be easy!

All currently created pages can be edited by a registered user. Each page has a format laid out in the Page layout document. The sections of the page are important, because their presence allows the wiki to remove all key points, videos etc into another page.

Editing a page uses a wiki editor. The editor uses wiki markup, which is simple to learn. If you don't have time to learn it, that's ok, as the toolbar at the top lets you format your page.

To get an idea of what each page looks like, pick some random pages from the wiki to look at.

How does it work?

When you have an account, you can edit any page using the edit tab. A history of all changes is kept by the wiki software. If you are unsure about the content of a page, or wish to explain why you have made a change, this can be added in the discussion tab, an area used for debating changes to a page (for an example, check out any contentious page on wikipedia).

Important points on copyright

This wiki is a Creative Commons wiki. Any content you place onto the wiki will be considered copyright-free. The positive side of this is that any of the wiki can be re-used in notes, slides, booklets or anywhere else. The downside is that in order to keep this status, no copyright material can be used on the site. Please create images or source them if they have a CC license (many images can be found at [The mediawiki commons site]).

Notes on key points

Key points should be similar to learning points or simply worded success criteria. These could be combined into a concept checklist for each unit.

Notes on Information

Anything goes in the information section. It is particularly useful to find interactive examples of concepts, if this is possible. The language in the information section should be simple enough for a Higher candidate, with a summary of the right level at the start of the section.

Adding code to the information section

Looking at any SDD examples with code will explain how to add code snippets. The website trinket.io allows python, block and HTML code to be embedded into an editor on your page.

To create code snippets, a wiki include code can be used, combined with the ID of the trinket code (this appears in the URL of the trinket code).

{{#widget:Trinket |id=08b51bdfb2 |type=blocks }}

Similarly, any other web-based resource can be embedded in a page using an iframe.

{{#Widget:Iframe |url=http://highercomputingscience.org/software/6502js/snake.html |width=100% |height=570px}}

Information on videos

Videos can be embedded using the YouTube or SchoolsTube include code

{{#Widget:YouTube
|id=ToSjDJXH1L4
}}

{{#Widget:SchoolsTube
|id=cb7b6f56d652412287e0
}}

Information on further information

Links in this section should be brief, as they appear in Wikipedia.

Information on Test Yourself

There is a quiz editor installed on the wiki that allows making simple quizzes for use on each page. The code for this is simple and more can be found about this on Page layout

<quiz display=simple>
{How many items can an array hold?
|type="()"}
- Only one item.
|| No - arrays are designed to store lists of items
+ One or more items.
|| Yes, arrays are designed to store lists of items.
- No items, only index numbers.
|| Index numbers are used for addressing each item.
</quiz>

Information on Teaching resources

Teaching resources could link to any document or website that could help with teaching this concept. Once the wiki is complete, this area could be expanded to make it easier to meaningfully share resources.