Difference between pages "FOSS Field Trip (Activity)" and "Learning Activity Format with Directions"

From TeachingOpenSource
(Difference between pages)
m (77 revisions imported)
 
m
 
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{:Learning Activity Definition}}


{{Learning Activity Overview
== Using This Template ==
|title=
FOSS Field Trip - Browsing for FOSS Projects
|overview=  
Learners will explore the breadth of available FOSS projects as well as differences between GitHub and OpenHub.
|prerequisites=
None.
|objectives=
# Search for FOSS projects on both GitHub and OpenHub.
# Use and describe different features of GitHub and OpenHub.
|process skills=
# Critical Thinking
# Information Processing
}}


=== Background ===
The template below contains sections which describe the items that should be included when creating a learning activity. To use this template:
# Create a new page with the word "Activity" in the name. Use a short, descriptive name.
# Copy the source for this template into your new page.
# Fill in the sections below according to the instructions.
# Categorize the page using tags at the bottom of the page.
#* Include <nowiki>[[Category:Learning Activity]]</nowiki>
#* Remove <nowiki>[[Category:Template]]</nowiki>, since this page is a template, but your new page is not.
#* Add at least one subcategory from the list in [[Learning Activities]], e.g. <nowiki>[[Category:Coding and Style]]</nowiki>
# Use the '''Discussion''' tab (upper left of the page) to leave feedback to the author(s) of the activity, such as usage or suggestions for enhancements.


FOSS predates the web, but the web is now essential for most FOSS projects.
People locate and access FOSS projects on the web, and FOSS communities collaborate on the web.
A FOSS project has a set of files (including source code, documentation, etc), usually organized into folders.
Most FOSS projects keep the complete history of every file, to know what changes were made, by who, and when.
The set of files and their history is a '''repository''', or a '''repo''' for short.


Most FOSS projects also use web-based collaborative tools to develop and share code and documentation,
== TEMPLATE ==
track who does what, and discuss questions, problems, and suggestions.
A software platform with these tools is a '''forge'''.
Some forges support ''one'' FOSS project (usually a ''large'' project),
and other forges host ''many'' independent FOSS projects.
Well known forges include [https://github.com GitHub], [https://sourceforge.net SourceForge], and [https://bitbucket.org Bitbucket].
Note that the software used by such sites is also called a '''forge''';
for example, [https://gitlab.com GitLab], [https://redmine.org RedMine], and [https://trac.edgewall.org Trac]
are FOSS forges that anyone can install and modify, unlike [https://github.com GitHub].


This activity also uses '''OpenHub''' (formerly '''Ohloh'''),
{| border="1"
which is ''not'' a forge, but mines data from forges to analyze project activity.
|-
|'''Title''' || Name of the activity
|-
|'''Overview''' || High level description of what the student will do
|-
|'''Prerequisite Knowledge''' || What topics and tools does the student need to know prior to beginning this activity?
|-
|'''Learning Objectives''' || What should the student be able to do after completing this activity?
|}


=== Directions ===
=== Background: ===
Is there background reading material?


* ''POSSE Attendees'': Post your answers on your foss2serve wiki page.
Are there other activities the student should have done first?
* ''Students'': Ask your instructor how to report your answers.


==== Part 1 - GitHub ====
What is the rationale for this activity?


In Part 1 you will search '''GitHub''' for projects. Do the following:
Include helpful hints to faculty here.
# Open a new browser tab and go to: https://github.com
# Find the search box near the top of the page, type "education", and press enter or click on the search icon.
## How many ''repositories'' are found for "education"? {{Answer|~25,000 (as of 2019-01)}}
## How many of these repos use the JavaScript language? (Hint: Find a summary table.) {{Answer|~3000 (as of 2019-01)}}
## In the first page of results, which repo was updated ''most'' recently? Which was updated ''least'' recently? {{Answer|Answers will vary, and may range from a few hours ago to several years ago.}}
# Many repos are small and inactive. To see the most active repos, find ''Sort'' and pick ''most stars''.
## Which ''education'' repo has the most stars? How many? {{Answer|freeCodeCamp with ~300k (as of 2019-01)}}
# Click on this repo to see its overview page. Scroll down past the list of files to see a project description.
# In GitHub, each reported problem or suggestion is an '''issue''', the code and documentation to fix an issue is a '''pull request''', and a pull request that is accepted and added to a repo is a '''commit'''. Each issue and pull request is either ''open'' (in progress) or ''closed'' (done). (You will learn more about all of this later.)
## At the top of the overview page, click on the ''Issues'' tab. You should see a list. How many issues are ''open''? ''closed''? {{Answer|~350 and ~13k for freeCodeCamp (as of 2019-01)}}
## Click on the ''Pull requests'' tab. You should see a list. How many pull requests are ''open''? ''closed''? {{Answer|~5000 and ~16k for freeCodeCamp (as of 2019-01)}}
## Click on the ''Insights'' tab. What do you see? {{Answer|Bargraphs of issues, pull requests, and commits this week.}}
## Within ''Insights'', go to the left menu and click on ''Commits''. What do you see? {{Answer|A bargraph showing the number of commits each week for the last year.}}
# Go back to the main GitHub page.
## Search for "humanitarian" projects. How many repos are found? {{Answer|~350 (as of 2019-01)}}
## Find ''HTBox/crisischeckin''. How many stars does it have? What language(s) does it use? When was the last update? {{Answer|~200 stars, C#, date will vary (as of 2019-01)}}
## Search for "disaster management", or terms that interest you. How many repos are found? {{Answer|Varies}}


Keep the GitHub browser tab open as you move on to Part 2.
=== Directions: ===
What should the student do?


==== Part 2 - OpenHub ====
=== Deliverables: ===
 
What will the student hand in?
In Part 2, you will search '''OpenHub''' for projects. Do the following:
# Open a new browser tab and go to: https://www.openhub.net
# In the search box, type "education".
## The listing shows the number of ''pages'', not the number of ''projects''. By default, each page shows 10 projects. How many ''projects'' were found? {{Answer|~230 pages -> ~2300 projects (as of 2019-01)}}
# Many projects are small and inactive. To see the most active projects, find ''Sort by'' and pick ''Activity Level''.
## Which (if any) of the most active projects do you recognize? {{Answer|Varies, maybe Moodle, Sakai, DSpace.}}
# In the ''Sort by'' text box pick ''Relevance''. If necessary, go to the bottom of the screen and advance to pages 2, 3, ... in the listing until you find ''KDE Education'', and click on it.
## From the ''KDE Education'' page, click on ''Code Locations'' (on the right side). Are any of the repo locations on GitHub? {{Answer|No, all are on kde.org (as of 2019-01)}}
## Go back to ''KDE Education'', and click on ''Similar Projects'' (below ''Code Locations''). How many similar projects are listed? {{Answer|~10 (as of 2019-01)}}
## This page contains general information for the similar projects. What info is shown for each? {{Answer|name, activity level, language, license (as of 2019-01)}}
# Repeat your OpenHub search for both "humanitarian" and "disaster management", or terms that interest you.
## How many projects did each search return? {{Answer|Varies. ~30 for humanitarian, ~30 for disaster mgmt (as of 2019-01)}}
# Some projects show "Activity Not Available". Click on the pyramid icon and read the page shown. Why is "activity not available"? {{Answer|OpenHub could not access or analysis project data.}}
# Click on ''Organizations'' (near the top of the main OpenHub page).
## What info is shown? {{Answer|Most active orgs, newest orgs, stats by sector, etc (as of 2019-01)}}
# From ''Organizations'', search for "OpenMRS".
## Do the search results show projects or organizations? {{Answer|Organizations}}
## Find the project "OpenMRS Core". When was the last commit? {{Answer|Varies. 11 months ago (as of 2019-01)}}
# Go back to '''GitHub''' and search for the project "OpenMRS Core".  When was the last commit? {{Answer|Varies. 4 days ago (as of 2019-01)}}
## Why do you think these sites have different info? {{Answer|OpenHub might be looking in the wrong place, or misreading data.}}
# What are some benefits & drawbacks of searching for a project in both GitHub & OpenHub? {{Answer|???}}
 
=== Deliverables ===
 
* ''POSSE Attendees'': Please post the answers to these questions on your foss2serve user wiki page.
* ''Students'': Wiki posting describing your explorations of GitHub and OpenHub.


= 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.
=== Assessment: ===
They are not part of the learning activity that would be given to students.
How will the activity be graded?
How will learning will be measured? Ideally, there should be a way to measure each of the objectives described above.  


=== Assessment ===
How will feedback to the student be determined?


* How will the activity be graded?
Include sample assessment questions/rubrics. Feel free to indicate that the activity itself is not graded, however it would be helpful to include any questions that might be used at a later date to interpret learning, for example on a quiz or exam.  
* How will learning will be measured?
* Include sample assessment questions/rubrics.


{| class="wikitable"
The form of the assessment is expected to vary by assignment. One possible format is the table:
{| border="1" class="wikitable"
! Criteria
! Criteria
! Level 1 (fail)
! Level 1 (fail)
Line 112: Line 63:
! Level 4 (exceptional)
! Level 4 (exceptional)
|-
|-
| '''The purpose of the project'''
| '''Criterion 1...'''
|  
|  
|  
|  
Line 119: Line 70:


|-
|-
| '''Why the project is open source'''
| '''Criterion 2...'''
|  
|  
|  
|  
Line 127: Line 78:
|}
|}


=== Comments ===
=== Comments: ===
What should the instructor know before using this activity?


* What should the instructor know before using this activity?
What are some likely difficulties that an instructor may encounter using this activity?
* What are some likely difficulties that an instructor might encounter using this activity?


=== Variants and Adaptations: ===
=== Additional Information: ===
{| 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 in Appendix A - The Body of Knowledge (page 58) - https://www.acm.org/education/CS2013-final-report.pdf
|-
|'''Level of Difficulty''' || Is this activity easy, medium or challenging?
|-
|'''Estimated Time to Completion''' ||  How long should it take for the student to complete the activity?
|-
|'''Materials/Environment''' || What does the student need?  Internet access, IRC client, Git Hub account, LINUX machine, etc.?
|-
|'''Author(s)''' || Who wrote this activity?
|-
|'''Source''' || Is there another activity on which this activity is based?  If so, please provide a link to the original resource.
|-
|'''License''' || Under which license is this material made available? We request that you pick a Creative Commons license.  See http://creativecommons.org/licenses/ for general information.  Suggested text: This learning activity is available for use under the [http://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0 International License].  Attribution need not include a link back to this site.
|}


[https://github.com/ChrisMurphyOnline/open-source-software-development-course/blob/master/activities/foss-evaluation-activity.txt POGIL-style combined FOSS Field Trip and Project Evaluation] used by [[User:Cmurphy|Chris Murphy]] in his [[FOSS Course, UPenn, Murphy]].
=== Suggestions for Open Source Community: ===
Suggestions for an open source community member who is working in conjunction with the instructor.


{{Learning Activity Info
--------------------
|acm unit=
The blank template for this page is licensed under a [http://creativecommons.org/licenses/by/4.0/ Creative Commons Attribution 4.0 International License] Anyone using this template need not include a link back to this site as part of attribution.
|acm topic=
|difficulty=
|time=
30-60 minutes
|environment=
Access to Internet/Web and web browser.
|author=
|source=
[http://www.xcitegroup.org/softhum/doku.php?id=f:assignment_ossfieldtrip1detail Detailed FOSS Field Trip]
|license=
{{License CC BY SA}}
}}


=== Suggestions for Open Source Community ===
[[File:CC-BY.png]]


Suggestions for an open source community member who is working in conjunction with the instructor.
[[Category:Learning Activity]]
[[Category:LEARNING_ACTIVITY_SUBCATEGORY]]


[[Category:Instructor Activities]]
When creating a new activity, remove it from the Templates category.
[[Category:Learning Activity]]
[[Category:Templates]]
[[Category:Introduction]]
[[Category:CS Principles]]
[[Category:CS1]]
[[Category: Good Draft]]

Revision as of 11:27, 26 January 2017

Learning Activity Definition

Using This Template

The template below contains sections which describe the items that should be included when creating a learning activity. To use this template:

  1. Create a new page with the word "Activity" in the name. Use a short, descriptive name.
  2. Copy the source for this template into your new page.
  3. Fill in the sections below according to the instructions.
  4. Categorize the page using tags at the bottom of the page.
    • Include [[Category:Learning Activity]]
    • Remove [[Category:Template]], since this page is a template, but your new page is not.
    • Add at least one subcategory from the list in Learning Activities, e.g. [[Category:Coding and Style]]
  5. Use the Discussion tab (upper left of the page) to leave feedback to the author(s) of the activity, such as usage or suggestions for enhancements.


TEMPLATE

Title Name of the activity
Overview High level description of what the student will do
Prerequisite Knowledge What topics and tools does the student need to know prior to beginning this activity?
Learning Objectives What should the student be able to do after completing this activity?

Background:

Is there background reading material?

Are there other activities the student should have done first?

What is the rationale for this activity?

Include helpful hints to faculty here.

Directions:

What should the student do?

Deliverables:

What will the student hand in?

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:

How will the activity be graded?

How will learning will be measured? Ideally, there should be a way to measure each of the objectives described above.

How will feedback to the student be determined?

Include sample assessment questions/rubrics. Feel free to indicate that the activity itself is not graded, however it would be helpful to include any questions that might be used at a later date to interpret learning, for example on a quiz or exam.

The form of the assessment is expected to vary by assignment. One possible format is the table:

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

Comments:

What should the instructor know before using this activity?

What are some likely difficulties that an instructor may encounter using this activity?

Additional Information:

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 in Appendix A - The Body of Knowledge (page 58) - https://www.acm.org/education/CS2013-final-report.pdf
Level of Difficulty Is this activity easy, medium or challenging?
Estimated Time to Completion How long should it take for the student to complete the activity?
Materials/Environment What does the student need? Internet access, IRC client, Git Hub account, LINUX machine, etc.?
Author(s) Who wrote this activity?
Source Is there another activity on which this activity is based? If so, please provide a link to the original resource.
License Under which license is this material made available? We request that you pick a Creative Commons license. See http://creativecommons.org/licenses/ for general information. Suggested text: This learning activity is available for use under the Creative Commons Attribution-ShareAlike 4.0 International License. Attribution need not include a link back to this site.

Suggestions for Open Source Community:

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

The blank template for this page is licensed under a Creative Commons Attribution 4.0 International License Anyone using this template need not include a link back to this site as part of attribution.

File:CC-BY.png

When creating a new activity, remove it from the Templates category.

Retrieved from "https://teachingopensource.org/index.php?title=FOSS_Field_Trip_(Activity)&oldid=6192"
Powered by MediaWiki