Intro to Wiki (Activity)

From Foss2Serve
(Difference between revisions)
Jump to: navigation, search
(update participants page link)
 
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{| border="1"
 
|-
 
|'''Title''' || Wiki Activity
 
|-
 
|'''Overview''' || Provides an overview of wikis and teaches basic skills for creating and editing wiki pages. 
 
|-
 
|'''Prerequisite Knowledge''' || None.
 
|-
 
|'''Learning Objectives''' || Upon completion of this activity, students will be able to: 1) Describe typical uses of wikis, 2) Create and edit a wiki page, 3) Discuss use of wikis in FOSS projects.
 
|}
 
  
=== Background: ===
+
{{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=
 +
}}
 +
 
 +
=== 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]
 
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]
  
Line 39: Line 44:
 
For our learning activity we will focus on Media Wiki, the wiki software that powers Wikipedia.   
 
For our learning activity we will focus on Media Wiki, the wiki software that powers Wikipedia.   
  
 +
=== Directions ===
  
=== Directions: ===
 
 
==== Part 1 - Introduction to Wikis ====
 
==== 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?)
 +
#* 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.
 
As part of your introduction to other POSSE participants, please create a short bio page for yourself in foss2serve.org.
 
Do the following:
 
Do the following:
# Go to the [http://www.foss2serve.org Foss2serve] wiki.
+
# Go to the [http://www.foss2serve.org 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.
 
# 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 [[User:Hislop | here]] and begin to create your page by modifying the URL of this example, changing the user ID to your own user ID.
+
# 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.
# Edit the participants page for this POSSE and add your own name and link your name to the User page you created in the prior step.  Please keep the names in alphabetic order by last name.  In a later activity, you will create a blog and add the link to your blog here too. The participants page is [[POSSE_201606_Participants | here]]
+
# 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 ====
  
==== Part 3 - Wiki Examples ====
 
 
# Browse several example wikis and try to define the role that they play.  Starting points:
 
# 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 4 million articles, 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 browse by starting at http://en.wikipedia.org/wiki/Wikipedia:About
+
#* '''[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.
+
#* '''[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 ===
  
=== 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 and (in a later assignment) a link to your blog
+
  
POSSE attendees: 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 =
 
= 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.
 
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): ===
+
=== 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.'''
+
 
 +
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 the activity be graded?
Line 74: Line 86:
 
* Include sample assessment questions/rubrics.
 
* Include sample assessment questions/rubrics.
  
{| border="1" class="wikitable"
+
{| class="wikitable"
 
! Criteria
 
! Criteria
 
! Level 1 (fail)
 
! Level 1 (fail)
Line 96: Line 108:
 
|}
 
|}
  
=== Comments: ===
+
=== Comments ===
 +
 
 
Comments to instructor using this activity with students:
 
Comments to instructor using this activity with students:
 
* Some discussion with students about wiki etiquette may be helpful.
 
* Some discussion with students about wiki etiquette may be helpful.
 
* Part 2 will need to be modified with instructions for an outside wiki.
 
* Part 2 will need to be modified with instructions for an outside wiki.
  
=== Additional Information: ===
+
{{Learning Activity Info
{| border="1"
+
|acm unit=
|-
+
Social Issues and Professional Practice
|'''ACM Knowledge Area/Knowledge Unit''' || Social Issues and Professional Practice [[ACM_Body_of_Knowledge]]
+
|acm topic=
|-
+
|difficulty=
|'''ACM Topic''' || Unclear - https://www.acm.org/education/CS2013-final-report.pdf
+
Easy
|-
+
|time=
|'''Level of Difficulty''' || Easy
+
30 minutes
|-
+
|environment=
|'''Estimated Time to Completion''' ||  30 minutes
+
Access to the Web via a web browser.  
|-
+
|author=
|'''Materials/Environment''' || Access to the Web via a web browser.  
+
Greg Hislop
|-
+
|source=
|'''Author''' || Greg Hislop
+
|license=
|-
+
{{License CC BY SA}}
|'''Source''' ||
+
}}
|-
+
 
|'''License''' ||  Licensed CC BY-SA  
+
=== Suggestions for Open Source Community ===
|}
+
  
=== Suggestions for Open Source Community: ===
 
 
Suggestions for an open source community member who is working in conjunction with the instructor:
 
Suggestions for an open source community member who is working in conjunction with the instructor:
 
*
 
*
  
--------------------
+
[[Category:Instructor Activities]]
This work is licensed under a
+
[[Category:Communication and Tools]]
[http://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0 International License]
+
 
+
[[File:CC_license.png]]
+
 
+
[[Category: Learning_Activity]]
+
 
+
[[Category:Communication_and_Tools]]
+
 
+
[[Category: CS Principles]]
+

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:
  1. Describe typical uses of wikis.
  2. Create and edit a wiki page.
  3. 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

  1. 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
  2. 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:

  1. Go to the foss2serve wiki.
  2. 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.
  3. 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.
  4. 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.
  5. 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

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

CC license.png


Suggestions for Open Source Community

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

Personal tools
Namespaces
Variants
Actions
Events
Learning Resources
HFOSS Projects
Evaluation
Navigation
Toolbox