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: @@
 __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, you 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]
@@ Line 39: / Line 44: @@
 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?)
+#* 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 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.
-# 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:
-* '''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.
-=== Assessment (possible rubrics for student assignment): ===
+= Notes for Instructors =
-'''Below are the questions that need to be answered to provide assessment for this activity along with a sample assessment table.'''
+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?
@@ Line 71: / Line 86: @@
 * Include sample assessment questions/rubrics.
-{| border="1" class="wikitable"
+{| class="wikitable"
 ! Criteria
 ! Level 1 (fail)
@@ Line 93: / Line 108: @@
 |}
-=== Comments: ===
+=== Comments ===
-What should the instructor know before using this activity?
-What are some likely difficulties that an instructor may encounter using this activity?
+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.
+{{Learning Activity Info
+|acm unit=
+Social Issues and Professional Practice
+|acm topic=
+|difficulty=
+Easy
+|time=
+minutes
+|environment=
+Access to the Web via a web browser.
+|author=
+Greg Hislop
+|source=
+|license=
+{{License CC BY SA}}
+}}
-=== Additional Information: ===
+=== Suggestions for Open Source Community ===
-{| border="1"
-|-
-|'''ACM Knowledge Area/Knowledge Unit''' || What ACM Computing Curricula 2013 knowledge area and units does this activity cover? [[ACM_Body_of_Knowledge]]
-|-
-|'''ACM Topic''' || What specific topics are addressed? The Computing Curriucula 2013 provides a list of topics - https://www.acm.org/education/CS2013-final-report.pdf
-|-
-|'''Level of Difficulty''' || Is this activity easy, medium or challenging?
-|-
-|'''Estimated Time to Completion''' ||  30 minutes
-|-
-|'''Materials/Environment''' || Access to the Web via a web browser.
-|-
-|'''Author''' || Greg Hislop
-|-
-|'''Source''' ||
-|-
-|'''License''' ||  	Licensed CC BY-SA
-|}
-=== Suggestions for Open Source Community: ===
 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]]

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