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''' ||To understand typical uses of wikis.
-To create and edit a wiki page.
-|-
-|'''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]
-According to wikipedia: [http://en.wikipedia.org/wiki/Blog]
-"A blog (a portmanteau of the term web log) is a discussion or informational site published on the World Wide Web and consisting of discrete entries ("posts") typically displayed in reverse chronological order (the most recent post appears first). ... Many blogs provide commentary on a particular subject; others function as more personal online diaries; others function more as online brand advertising of a particular individual or company. A typical blog combines text, images, and links to other blogs, Web pages, and other media related to its topic. The ability of readers to leave comments in an interactive format is an important contribution to the popularity of many blogs. Most blogs are primarily textual, although some focus on art (art blogs), photographs (photoblogs), videos (video blogs or "vlogs"), music (MP3 blogs), and audio (podcasts). Microblogging is another type of blogging, featuring very short posts. In education, blogs can be used as instructional resources. These blogs are referred to as edublogs."
-Blogs provide:
+'''The Need for Web publishing'''
-* Immediate availability with long term accessibility
+* Quick publication via the Web
-* No HTML knowledge required
+* Decentralized control
-What makes a Web site a Blog?
+** But room for recovery
-* Personal writing with byline
+* Web page creation without HTML knowledge
-* Can be an individual or a group
-* Short entries – a paragraph to a few pages
+'''The Solution - Wikis'''
-* Dated entries – usually displayed in reverse chronological order
+* Access via a Web browser
-* Themed and often opinion based
+* Simple text editor
-** Business topic
+* Character based formatting
-** (for personal blogs) hobby, diary, report of cat activities
+* Built-in change tracking and roll-back
-Blog to blog connections are common
-* Blogs cite each other
+'''Wiki History'''
-* Multiplies visibility of postings
+* Predecessors
-* Expands communities
+** Memex, hypertext, hypercards
-Blog posts as threaded discussion triggers
+* Wiki Wiki Web - 1994
-* Many blogs allow comment posting
+** Ward Cunningham
-* Blogger controls thread topic by always posting the initial thread item
+* Today: Lots of Wiki systems
-Blog posts can have tags and categories
+** Major platforms include: Media Wiki, Docuwiki, Tikiwiki, MoinMoin
-* Which can support routing or selection of posts
+** Wiki text syntax is generally similar across platforms but with enough variation to be confusing
-* RSS (and RDF and Atom) provides a push technology letting people “subscribe” to a blog
+** Wiki Creole attempts to provide a standard but has not been completely adopted
-* Blog planets provide a way to collect a stream of related blog posts
-Blog Planet
+For our learning activity we will focus on Media Wiki, the wiki software that powers Wikipedia.
-* Definition A: Software to aggregate blog postings from a group of blogs
-** Example: http://www.planetplanet.org/
+=== Directions ===
-* Definition B: A Web site that uses planet software to present an aggregation of blogs
-** Example: http://planet.fedoraproject.org/
-=== 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 than the Wikipedia article?)
-# If you are not familiar with wiki syntax and page editing, please read the
-==== 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 [https://wordpress.com/ wordpress.com].
+# Go to the [http://www.foss2serve.org foss2serve wiki].
-# Click Get Started and fill out the form provided.
+# 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.
-# Fill in basic information in your profile
+# 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