From Foss2Serve

(Difference between revisions)

Jump to: navigation, search

Latest revision as of 16:56, 22 February 2019

Title	Intro to Wiki
Overview	Provides an overview of wikis and teaches basic skills for creating and editing wiki pages.
Prerequisites	None.
Learning Objectives	After successfully completing this activity, the learner should be able to: Describe typical uses of wikis. Create and edit a wiki page. Discuss use of wikis in FOSS projects.
Process Skills Practiced

Background

According to Wikipedia: "A wiki is a website which allows its users to add, modify, or delete its content via a web browser usually using a simplified markup language or a rich-text editor. Wikis are powered by wiki software. Most are created collaboratively." [1]

The Need for Web publishing

Quick publication via the Web
Decentralized control
- But room for recovery
Web page creation without HTML knowledge

The Solution - Wikis

Access via a Web browser
Simple text editor
Character based formatting
Built-in change tracking and roll-back

Wiki History

Predecessors
- Memex, hypertext, hypercards
Wiki Wiki Web - 1994
- Ward Cunningham
Today: Lots of Wiki systems
- Major platforms include: Media Wiki, Docuwiki, Tikiwiki, MoinMoin
- Wiki text syntax is generally similar across platforms but with enough variation to be confusing
- Wiki Creole attempts to provide a standard but has not been completely adopted

For our learning activity we will focus on Media Wiki, the wiki software that powers Wikipedia.

Directions

Part 1 - Introduction to Wikis

Read the Wiki article (Wikipedia). (After all, what starting point can there be for wikis other than the Wikipedia article?)
- In particular, read sections 1-4: Characteristics, History, Definitions, Implementations
Read the MediaWiki pages on how to edit and create pages.

Part 2 - Create a Wiki Page

As part of your introduction to other POSSE participants, please create a short bio page for yourself in foss2serve.org. Do the following:

Go to the foss2serve wiki.
Login and change your password. You should have received a user ID and temporary password by email. If you did not, please contact Greg Hislop at hislop@drexel.edu.
Create a new "User" page in the wiki for your user ID. You can see an example and begin to create your page by modifying the URL of this example, changing the user ID to your own user ID.
Edit POSSE 2019-06 Participants, add your own name, and link your name to the User page you just created. Please keep the names in alphabetic order by last name.
In later activities, you will continue to edit your user page. For example, you might create a blog and have you user page link to your blog.

Part 3 - Browse Wiki Examples

Browse several example wikis and try to define the role that they play. Starting points:
- Wikipedia is most widely known and used wiki. With over 5 million articles in English, it can be overwhelming. On the other hand, it contains lots of material about writing wiki pages, organizing wikis, managing large wikis, and using advanced features of MediaWiki. You might start at http://en.wikipedia.org/wiki/Wikipedia:About.
- The Fedora Project Wiki is an example of a relatively large wiki used to support a FOSS project. The wiki provides a home for much of the technical documentation, and other materials related to operation of the Fedora project.

Deliverables

POSSE: A foss2serve user wiki page created with brief bio. Include a link to your blog if you have one.

A wiki page with a short biography.

Notes for Instructors

The remaining sections of this document are intended for the instructor. They are not part of the learning activity that would be given to students.

Assessment (possible rubrics for student assignment)

Below are the questions that need to be answered to provide assessment for this activity along with a sample assessment table.

How will the activity be graded?
How will learning will be measured?
Include sample assessment questions/rubrics.

Criteria	Level 1 (fail)	Level 2 (pass)	Level 3 (good)	Level 4 (exceptional)
Criteria 1
Criteria 2

Comments

Comments to instructor using this activity with students:

Some discussion with students about wiki etiquette may be helpful.
Part 2 will need to be modified with instructions for an outside wiki.

ACM BoK Area & Unit(s)	Social Issues and Professional Practice
ACM BoK Topic(s)
Difficulty	Easy
Estimated Time to Complete	30 minutes
Environment / Materials	Access to the Web via a web browser.
Author(s)	Greg Hislop
Source
License	This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

Suggestions for Open Source Community

Suggestions for an open source community member who is working in conjunction with the instructor:

@@ Line 1: / Line 1: @@
-== Blog Activity ==
+__NOTOC__
-=== Preparation: ===
+{{Learning Activity Overview
+|title=
+Intro to Wiki
+|overview=
+Provides an overview of wikis and teaches basic skills for creating and editing wiki pages.
+|prerequisites=
+None.
+|objectives=
+# Describe typical uses of wikis.
+# Create and edit a wiki page.
+# Discuss use of wikis in FOSS projects.
+|process skills=
+}}
-{| border="1"
+=== Background ===
-|-
-|'''Description''' ||Learners will create learn wiki basics and edit a wiki page.
-|-
-|'''Source''' ||Greg Hislop
-|-
-|'''Prerequisite Knowledge''' || None.
-|-
-|'''Estimated Time to Completion''' || 30 minutes minutes
-|-
-|'''Learning Objectives''' ||Upon completion, you will be able to:
-Describe typical uses of wikis.
-Create and edit a wiki page.
-Discuss use of wikis in FOSS projects
-|-
-|'''Materials/Environment''' || Access to the Web via a web browser.
-|-
-|'''Rights''' || Licensed CC BY-SA
-|-
-|'''Turn In''' || A wiki page with a short biography and link to your blog
-|}
-=== Background: ===
 According to Wikipedia:  "A wiki is a website which allows its users to add, modify, or delete its content via a web browser usually using a simplified markup language or a rich-text editor. Wikis are powered by wiki software. Most are created collaboratively." [http://en.wikipedia.org/wiki/Wiki]
-For our learning activity we will focus on Media Wiki, the wiki software that powers Wikipedia.
+'''The Need for Web publishing'''
+* Quick publication via the Web
+* Decentralized control
+** But room for recovery
+* Web page creation without HTML knowledge
+'''The Solution - Wikis'''
+* Access via a Web browser
+* Simple text editor
+* Character based formatting
+* Built-in change tracking and roll-back
+'''Wiki History'''
+* Predecessors
+** Memex, hypertext, hypercards
+* Wiki Wiki Web - 1994
+** Ward Cunningham
+* Today: Lots of Wiki systems
+** Major platforms include: Media Wiki, Docuwiki, Tikiwiki, MoinMoin
+** Wiki text syntax is generally similar across platforms but with enough variation to be confusing
+** Wiki Creole attempts to provide a standard but has not been completely adopted
+For our learning activity we will focus on Media Wiki, the wiki software that powers Wikipedia.
+=== Directions ===
-=== Directions: ===
 ==== Part 1 - Introduction to Wikis ====
-# Read the overview [http://en.wikipedia.org/wiki/Wiki article] about wikis. (After all, what starting point can there be for wikis other than the Wikipedia article?)
-# Read basics of MediaWiki page [http://www.mediawiki.org/wiki/Help:Starting_a_new_page creation] and page [http://www.mediawiki.org/wiki/Help:Contents editing]
-==== Part 2 - Creating a wiki page ===
+# Read the [http://en.wikipedia.org/wiki/Wiki Wiki article (Wikipedia)]. (After all, what starting point can there be for wikis other than the Wikipedia article?)
-As part of your introduction to other POSSE participant, please create a short bio page for yourself in foss2serve.org.
+#* In particular, read sections 1-4: Characteristics, History, Definitions, Implementations
+# Read the [http://www.mediawiki.org MediaWiki] pages on how to [http://www.mediawiki.org/wiki/Help:Contents edit] and [http://www.mediawiki.org/wiki/Help:Starting_a_new_page create] pages.
+==== Part 2 - Create a Wiki Page ====
+As part of your introduction to other POSSE participants, please create a short bio page for yourself in foss2serve.org.
 Do the following:
-# Go to [foss2serve.org].
+# Go to the [http://www.foss2serve.org foss2serve wiki].
-# Login or create an account.  Note that when you create an account you will need to wait for approval by an administrator.
+# Login and change your password.  You should have received a user ID and temporary password by email.  If you did not, please contact Greg Hislop at hislop@drexel.edu.
-# Create a new page in the wiki
+# Create a new "User" page in the wiki for your user ID.  You can see [[User:Heidi.ellis|an example]] and begin to create your page by modifying the URL of this example, changing the user ID to your own user ID.
-# Fill in the “About” page
+# Edit [[POSSE 2019-06 Participants]], add your own name, and link your name to the User page you just created.  Please keep the names in alphabetic order by last name.
+# In later activities, you will continue to edit your user page. For example, you might create a blog and have you user page link to your blog.
+==== Part 3 - Browse Wiki Examples ====
+# Browse several example wikis and try to define the role that they play.  Starting points:
+#* '''[https://Wikipedia.org Wikipedia]''' is most widely known and used wiki.  With over 5 million articles in English, it can be overwhelming.  On the other hand, it contains lots of material about writing wiki pages, organizing wikis, managing large wikis, and using advanced features of MediaWiki.  You might start at http://en.wikipedia.org/wiki/Wikipedia:About.
+#* '''[https://fedoraproject.org/wiki/Fedora_Project_Wiki The Fedora Project Wiki]''' is an example of a relatively large wiki used to support a FOSS project.  The wiki provides a home for much of the technical documentation, and other materials related to operation of the Fedora project.
+=== Deliverables ===
+POSSE: A foss2serve user wiki page created with brief bio. Include a link to your blog if you have one.
+A wiki page with a short biography.
+= Notes for Instructors =
+The remaining sections of this document are intended for the instructor.  They are not part of the learning activity that would be given to students.
+=== Assessment (possible rubrics for student assignment) ===
+Below are the questions that need to be answered to provide assessment for this activity along with a sample assessment table.
+* How will the activity be graded?
+* How will learning will be measured?
+* Include sample assessment questions/rubrics.
+{| class="wikitable"
+! Criteria
+! Level 1 (fail)
+! Level 2 (pass)
+! Level 3 (good)
+! Level 4 (exceptional)
+|-
+| '''Criteria 1'''
+|
+|
+|
+|
+|-
+| '''Criteria 2'''
+|
+|
+|
+|
+|}
+=== Comments ===
+Comments to instructor using this activity with students:
+* Some discussion with students about wiki etiquette may be helpful.
+* Part 2 will need to be modified with instructions for an outside wiki.
-==== Part 3 - Posting to your blog ====
+{{Learning Activity Info
-Now that you have a blog, it is time to make a post.
+|acm unit=
-# This first post should be about you, the school you teach at, the courses you typically teach and your interest in incorporating HFOSS in your coursework.  It will be your introduction to the other people who will be attending the POSSE workshop in June.
+Social Issues and Professional Practice
-# Add a link to your blog by creating an entry on [ ]. Model your entry after the ones shown.  Please insert your link alphabetically by last name.
+|acm topic=
+|difficulty=
+Easy
+|time=
+minutes
+|environment=
+Access to the Web via a web browser.
+|author=
+Greg Hislop
+|source=
+|license=
+{{License CC BY SA}}
+}}
-==== Part 4 - Introduction to Planets ====
+=== Suggestions for Open Source Community ===
-# Read the following [http://en.wikipedia.org/wiki/Planet_software page] about planets.
-# Go to the [http://planet.teachingopensource.org/ Teaching Open Source Planet]
-==== Part 5 - Tagging your blog post so it appears on the TOS planet - OPTIONAL ====
+Suggestions for an open source community member who is working in conjunction with the instructor:
-# Go to the [http://teachingopensource.org/index.php/Planet_Feed_List TOS planet Feed]
+*
-# Tag your post with whatever tag you will use for posts that you want to appear on the Teaching Open Source Planet (suggestion: TOS).
-# Go to Teaching Open Source (http://teachingopensource.org/index.php/Main_Page) and create an account: (http://teachingopensource.org/index.php?title=Special:UserLogin&type=signup&returnto=Main+Page)
-# Add the URI for the feed for the TOS tag to the Planet Feed List (http://teachingopensource.org/index.php/Planet_Feed_List). You will have to edit the Feeds section to add the URI and your name. Follow the format of the other entries there.
-[[Category: Foss2serve]]
+[[Category:Instructor Activities]]
-[[Category: Learning_Activity]]
+[[Category:Communication and Tools]]

Intro to Wiki (Activity)

Latest revision as of 16:56, 22 February 2019

Background

Directions

Part 1 - Introduction to Wikis

Part 2 - Create a Wiki Page

Part 3 - Browse Wiki Examples

Deliverables

Notes for Instructors

Assessment (possible rubrics for student assignment)

Comments

Suggestions for Open Source Community

Personal tools

Namespaces

Variants

Views

Actions

Search

Events

Learning Resources

HFOSS Projects

Evaluation

Navigation

Toolbox