Evaluate a Project (Activity)

From Foss2Serve
(Difference between revisions)
Jump to: navigation, search
(Walk through of an evaluation of the OpenMRS project.)
m (Evaluated for adoption readiness)
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{| border="1"
+
=<span style="color:#ff0000"> This activity has been revised. The newer version is [http://foss2serve.org/index.php/Project_Evaluation_(Activity) here] </span>=
|-
+
|'''Title''' || Project Evaluation Activity
+
|-
+
|'''Overview''' || Learners will gain an understanding of the breadth of available FOSS projects. Learners will also gain an understanding of the identifying characteristics of FOSS projects including pattern of contributions, patterns of commits, programming languages used, and more.
+
|-
+
|'''Prerequisite Knowledge''' || Completion of Browsing a Forge Activity or understanding of SourceForge and OpenHub; Understanding of the course in which students will be participating in an HFOSS project.
+
|-
+
|'''Learning Objectives''' || Ability to identify likely HFOSS projects.
+
|}
+
  
 +
{{Learning Activity Overview
 +
|title=
 +
Evaluate a Project
 +
|overview=
 +
Learners will gain an understanding of the breadth of available HFOSS projects. Learners will also gain an understanding of the identifying characteristics of HFOSS projects including pattern of contributions, patterns of commits, programming languages used, and more. 
 +
|prerequisites=
 +
* Completion of [[FOSS Field Trip (Activity)]] or understanding of SourceForge and OpenHub; Understanding of the course in which students will be participating in an HFOSS project.
 +
|objectives=
 +
* Identify likely HFOSS projects.
 +
|process skills=
 +
}}
 +
 +
=== Background ===
  
=== Background: ===
 
 
This activity is intended to give you an overview of what to consider when evaluating an HFOSS project for student participation and for you to gain experience using the rubric.
 
This activity is intended to give you an overview of what to consider when evaluating an HFOSS project for student participation and for you to gain experience using the rubric.
  
=== Directions: ===
+
=== Directions ===
====Walk through of an evaluation of the OpenMRS project.====
+
 
There are many criteria which should be looked at when determining if a project is appropriate to use in your class.  These criteria are broken into two groups - mission critical and secondary.  For this exercise, the secondary criteria is optional.
+
==== Walk through of an evaluation of the OpenMRS project ====
:'''Mission Critical Criteria-Viability'''
+
  
#Size/Scale/Complexity - An ideal project should be neither overly simple nor overly complex.
+
There are many criteria which should be looked at when determining if a project is appropriate to use in your class. These criteria are broken into two groups - mission critical and secondary.
##Go to the OpenMRS web page (http://openmrs.org/), scroll to the bottom and choose ''OpenMRS Wiki'' (under ''Other OpenMRS sites''). From the menu on the left expand the ''Developer Guide'' and the ''Getting Started as a Developer'' options and then choose ''Technical Overview''. From examination of the technology stack, the architecture looks modular and further search shows it is documented elsewhere on the site. This provides a first look at the complexity of the application and the number and various different technologies involved.
+
For this exercise, the secondary criteria are optional.
##Based upon the results from OpenHub (gathered in the FOSS Field Trip activity) and the information from the OpenMRS Technical Overview page, think about the size of the code base and how many different technologies and layers are involved in the application. What would you score this project for size/scale/complexity?
+
#Activity - To support student participation a project should be reasonably active. Number of commits can be used as an indicator of activity. 
+
##Based upon the number of commits (gathered in the FOSS Field Trip activity) would you consider this project active?  Why or why not?
+
#Community - A suitable project has an active user community.  While it is difficult to quantitatively evaluate the activity of a user community, some indicators include a regular history of project downloads and documentation updates over time, current activity on user mailing lists, and testimonials on the project web site.
+
##Examine download activity
+
###Go to [http://sourceforge.net/ sourceforge.net] and enter OpenMRS into the search box. 
+
###Choose OpenMRS from the search results.
+
###Click on the number of downloads that is listed on the project page.
+
###Change the date range to give a graph of downloads over the last year. 
+
##OpenMRS has begun migrating legacy mailing list activity to OpenMRS Talk. Examine [https://talk.openmrs.org/ discussion] activity
+
##Examine the [https://botbot.me/freenode/openmrs/ IRC logs]
+
##Based upon the download history, discussion activity, and IRC activity, do you feel this project has a good community?  Why or why not?
+
  
 +
:'''Mission Critical Criteria - Viability'''
  
:'''Mission Critical Criteria-Approachability'''
+
# Size/Scale/Complexity - An ideal project should be neither overly simple nor overly complex.
 +
## Go to the OpenMRS web page (http://openmrs.org/), scroll to the bottom and choose ''OpenMRS Wiki'' (under ''Other OpenMRS sites''). From the menu on the left expand the ''Developer Guide'' and the ''Getting Started as a Developer'' options and then choose ''Technical Overview''. From examination of the technology stack, the architecture looks modular and further search shows it is documented elsewhere on the site. This provides a first look at the complexity of the application and the number and various different technologies involved.
 +
## Based upon the results from OpenHub (gathered in the FOSS Field Trip activity) and the information from the OpenMRS Technical Overview page, think about the size of the code base and how many different technologies and layers are involved in the application. What would you score this project for size/scale/complexity on a scale of one to three where one is "low" and three is "high".
 +
# Activity - To support student participation a project should be reasonably active.  Number of commits can be used as an indicator of activity. 
 +
## Based upon the number of commits (gathered in the FOSS Field Trip activity) would you consider this project active?  Why or why not?
 +
# Community - A suitable project has an active user community.  While it is difficult to quantitatively evaluate the activity of a user community, some indicators include a regular history of project downloads and documentation updates over time, current activity on user mailing lists, and testimonials on the project web site.
 +
## Examine download activity
 +
### Go to [http://sourceforge.net/ sourceforge.net] and enter OpenMRS into the search box. 
 +
### Choose OpenMRS from the search results.
 +
### Click on the number of downloads that is listed on the project page.
 +
### Change the date range to give a graph of downloads over the last year. 
 +
## OpenMRS has begun migrating legacy mailing list activity to OpenMRS Talk. Examine [https://talk.openmrs.org/ discussion] activity
 +
## Examine the [https://botbot.me/freenode/openmrs/ IRC logs]
 +
## Based upon the download history, discussion activity, and IRC activity, do you feel this project has a good community?  Why or why not?
 +
 
 +
:'''Mission Critical Criteria - Approachability'''
  
 
:Here you are evaluating a project's on-ramp to contribution, scoring as follows:
 
:Here you are evaluating a project's on-ramp to contribution, scoring as follows:
  
::1-Insufficient-Few or no pointers on how to become involved.
+
::1 - Insufficient - Few or no pointers on how to become involved.
  
::2-Sufficient-Suggestions about how to get involved other than contributing money with accompanying high-level instructions.
+
::2 - Sufficient - Suggestions about how to get involved other than contributing money with accompanying high-level instructions.
  
::3-Ideal-Obvious link to get started, list of suggestions for things to do and detailed instructions.
+
::3 - Ideal - Obvious link to get started, list of suggestions for things to do and detailed instructions.
  
#Examine project on-ramp.
+
# Examine project on-ramp.
##Link to getting started - The website has a [http://openmrs.org/help/ Get Involved page] with links to ways you can contribute and share your ideas.   
+
## Link to getting started - The website has a [http://openmrs.org/help/ Get Involved page] with links to ways you can contribute and share your ideas.   
##Each of the links (Develop, Test, Document, Translate) contain more detailed information about what and how you can contribute.  
+
## Each of the links (Develop, Test, Document, Translate) contain more detailed information about what and how you can contribute.  
##The [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer Getting Started as a Developer] page contains a detailed list of how to get started including a list of introductory issues.
+
## The [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer Getting Started as a Developer] page contains a detailed list of how to get started including a list of introductory issues.
##Detailed instructions - The [https://wiki.openmrs.org/display/docs/Developer+Guide Developer Guide] contains instructions and information in many areas including process, architecture, tools, and developer documentation.
+
## Detailed instructions - The [https://wiki.openmrs.org/display/docs/Developer+Guide Developer Guide] contains instructions and information in many areas including process, architecture, tools, and developer documentation.
##Based upon the resources you looked at, how would you rate the approachability of the OpenMRS project?  
+
## Based upon the resources you looked at, how would you rate the approachability of the OpenMRS project?  
  
  
 
:'''Mission Critical Criteria-Suitability'''
 
:'''Mission Critical Criteria-Suitability'''
#Appropriate Artifacts - Since evaluation is dependent on class objectives, in this example we'll assume the objective is to learn the process of working in an authentic development environment by contributing bug fixes to OpenMRS.
 
##Opportunities to contribute bug fixes - Examine the issues found at the bottom of the [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer getting started as a developer page].  How are the introductory issues categorized?  How many issues are listed?
 
##Documentation on how to contribute bug fixes - On the [https://wiki.openmrs.org/display/docs/Tickets Tickets page] there is information on how to create and work on an issue, including links to coding standards and the code submission process. Review this information.
 
##Based upon the number of bugs suitable for students to tackle and information on the process of how to submit bug fixes, do you think this would be an appropriate project for your students?  Why or why not?
 
#Contributor Support - Does the project have a high volume of guidance to help students as they learn?
 
##Communication Tools - Communication tools are directly available from any of the Wiki Spaces (Documentation, Projects, Resources). The [https://wiki.openmrs.org/display/RES/Home Resources page] contains links to OpenMRS Talk and IRC Chat, as well as links to group meetings (under Events), and training opportunities. 
 
##Web Presence - Examine the [https://botbot.me/freenode/openmrs/ IRC logs]. Has there been activity during the last week? 
 
##Operating Processes - Links to information about coding standards, the code submission process, and commit privileges can be found on the [https://wiki.openmrs.org/display/docs/How-To+Submit+Code How-To Submit Code page].  The process for making feature requests is available on the [https://wiki.openmrs.org/display/docs/Tickets Tickets page]. Are these processes well documented?
 
##Response to Questions - Review a few of the posts on the OpenMRS [https://talk.openmrs.org/ discussion platform]. Do posts to this forum receive timely and supportive responses?
 
##How would you rate the support that newcomers to OpenMRS receive?
 
  
 +
# Appropriate Artifacts - Since evaluation is dependent on class objectives, in this example we'll assume the objective is to learn the process of working in an authentic development environment by contributing bug fixes to OpenMRS.
 +
## Opportunities to contribute bug fixes - Examine the issues found at the bottom of the [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer getting started as a developer page].  How are the introductory issues categorized?  How many issues are listed?
 +
## Documentation on how to contribute bug fixes - On the [https://wiki.openmrs.org/display/docs/Tickets Tickets page] there is information on how to create and work on an issue, including links to coding standards and the code submission process. Review this information.
 +
## Based upon the number of bugs suitable for students to tackle and information on the process of how to submit bug fixes, do you think this would be an appropriate project for your students?  Why or why not?
 +
# Contributor Support - Does the project have a high volume of guidance to help students as they learn?
 +
## Communication Tools - Communication tools are directly available from any of the Wiki Spaces (Documentation, Projects, Resources). The [https://wiki.openmrs.org/display/RES/Home Resources page] contains links to OpenMRS Talk and IRC Chat, as well as links to group meetings (under Events), and training opportunities. 
 +
## Web Presence - Examine the [https://botbot.me/freenode/openmrs/ IRC logs]. Has there been activity during the last week? 
 +
## Operating Processes - Links to information about coding standards, the code submission process, and commit privileges can be found on the [https://wiki.openmrs.org/display/docs/How-To+Submit+Code How-To Submit Code page].  The process for making feature requests is available on the [https://wiki.openmrs.org/display/docs/Tickets Tickets page]. Are these processes well documented?
 +
## Response to Questions - Review a few of the posts on the OpenMRS [https://talk.openmrs.org/ discussion platform]. Do posts to this forum receive timely and supportive responses?
 +
## How would you rate the support that newcomers to OpenMRS receive?
  
:'''On your blog, write a summary of why you think the OpenMRS project would be suitable for your course.  Be sure to include information about the course and reasons why OpenMRS would be a good/poor match.
+
 
 +
:'''On your wiki page, write a summary of why you think the OpenMRS project would be suitable for your course.  Be sure to include information about the course and reasons why OpenMRS would be a good/poor match.
  
  
Line 73: Line 80:
  
  
:'''Secondary Criteria-Viability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment'''
+
:'''Secondary Criteria - Viability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment'''
#Domain
+
 
##Does this project require domain knowledge that may be difficult for students to learn? OpenMRS is a medical records system. Students should be able to grasp it well enough to contribute a bug fix, which is the learning objective assumed in this example.
+
# Domain
##How would you rate the viability of OpenMRS?
+
## Does this project require domain knowledge that may be difficult for students to learn? OpenMRS is a medical records system. Students should be able to grasp it well enough to contribute a bug fix, which is the learning objective assumed in this example.
#Maturity  
+
## How would you rate the understandability of OpenMRS?
##To have the organization support student learning, the project should have at least one stable production release. The [https://wiki.openmrs.org/display/RES/Platform+Release+Notes Platform Release Notes page] lists releases.  
+
# Maturity
##Does OpenMRS have enough of a stable base to support student learning?  Why or why not?
+
## To have the organization support student learning, the project should have at least one stable production release. The [https://wiki.openmrs.org/display/RES/Platform+Release+Notes Platform Release Notes page] lists releases.  
#User Support  
+
## Does OpenMRS have enough of a stable base to support student learning?  Why or why not?
##The project should have clear instructions for downloading, installing, and using the project. As noted previously, the [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer Getting Started as a Developer page] provides detailed information about setting up and using the required tools, in addition there are detailed instructions related to installation, configuration, system requirements, and troubleshooting, including videos.
+
# User Support  
##Does the documentation seem sufficient for getting students started?
+
## The project should have clear instructions for downloading, installing, and using the project. As noted previously, the [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer Getting Started as a Developer page] provides detailed information about setting up and using the required tools, in addition there are detailed instructions related to installation, configuration, system requirements, and troubleshooting, including videos.
#Roadmap  
+
## Does the documentation seem sufficient for getting students started?
##Student learning is best supported by projects that have a roadmap that includes new feature development, a method for users to submit new feature requests and a process for identifying how new features are prioritized. Feature requests are made through JIRA, the OpenMRS issue tracker. Road map planning and the process for prioritizing feature requests is available on the [https://wiki.openmrs.org/display/docs/Technical+Road+Map+Planning Technical Roadmap Planning page].  Here you will find information about the planning process and how to participate in the planning process. The [https://wiki.openmrs.org/display/docs/Technical+Road+Map Technical Road Map page] identifies features, their current status, and a point of contact, in addition to expected dates of completion.  
+
# Roadmap  
 +
## Student learning is best supported by projects that have a roadmap that includes new feature development, a method for users to submit new feature requests and a process for identifying how new features are prioritized. Feature requests are made through JIRA, the OpenMRS issue tracker. Road map planning and the process for prioritizing feature requests is available on the [https://wiki.openmrs.org/display/docs/Technical+Road+Map+Planning Technical Roadmap Planning page].  Here you will find information about the planning process and how to participate in the planning process. The [https://wiki.openmrs.org/display/docs/Technical+Road+Map Technical Road Map page] identifies features, their current status, and a point of contact, in addition to expected dates of completion.  
 
##Does the roadmap provide you with enough information to make a decision about using it in your course?
 
##Does the roadmap provide you with enough information to make a decision about using it in your course?
  
  
:'''Secondary Criteria-Approachability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment'''
+
:'''Secondary Criteria - Approachability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment'''
#Contribution Types
+
 
##Does the project contain opportunities for multiple types of contribution and of the type that fits the class? There are multiple projects for testers, tech writers, and developers.  These can be seen on the [http://openmrs.org/help/ Get Involved page].
+
# Contribution Types
Are the number of and type of bugs available suitable for students given your course and the class size?  
+
## Does the project contain opportunities for multiple types of contribution and of the type that fits the class? There are multiple projects for testers, tech writers, and developers.  These can be seen on the [http://openmrs.org/help/ Get Involved page]. Are the number of and type of bugs available suitable for students given your course and the class size? Are there other ways that students could contribute?
#Openness to Contributions
+
# Openness to Contributions
##Acceptance of a student contribution to a project provides valuable affirmation to student learning.  Determine whether the project accepts student patches. The process for contribution is documented on the [https://wiki.openmrs.org/display/docs/Tickets Tickets page].  Does this project seem likely to accept student contributions?
+
## Acceptance of a student contribution to a project provides valuable affirmation to student learning.  Determine whether the project accepts student patches. The process for contribution is documented on the [https://wiki.openmrs.org/display/docs/Tickets Tickets page].  Does this project seem likely to accept student contributions?
#Student Friendliness
+
# Student Friendliness
 
## Do community members moderate the tone of communication?  Review the discussion platform and IRC to gauge tone. Review the [https://talk.openmrs.org/ discussion platform] and [https://botbot.me/freenode/openmrs/ IRC logs].  What was the tone of the communication?
 
## Do community members moderate the tone of communication?  Review the discussion platform and IRC to gauge tone. Review the [https://talk.openmrs.org/ discussion platform] and [https://botbot.me/freenode/openmrs/ IRC logs].  What was the tone of the communication?
  
  
:'''Secondary Criteria-Suitability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment'''
+
:'''Secondary Criteria - Suitability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment'''
#Project Description
+
# Project Description
##Students must be able to understand the purpose of the project.  Does the project clearly describe the product? Can students understand the intended uses of the product? - The [http://openmrs.org/about/ About page] provides an overview of who, where, and what OpenMRS is, including a downloadable PDF file and a video.  
+
## Students must be able to understand the purpose of the project.  Does the project clearly describe the product? Can students understand the intended uses of the product? - The [http://openmrs.org/about/ About page] provides an overview of who, where, and what OpenMRS is, including a downloadable PDF file and a video.  
#Platform
+
# Platform
##What software and hardware platform does the FOSS project run on? Development environment can be built on Windows, Linux or Mac OS X completely with FOSS software.  (Project development information found [https://wiki.openmrs.org/display/docs/Step+by+Step+Installation+for+Developers here])
+
## What software and hardware platform does the FOSS project run on? Development environment can be built on Windows, Linux or Mac OS X completely with FOSS software.  (Project development information found [https://wiki.openmrs.org/display/docs/Step+by+Step+Installation+for+Developers here])
##Are there resources to support these platforms?
+
## Are there resources to support these platforms?
##Are students familiar with the platforms?
+
## Are students familiar with the platforms?
#Development Features - Is the class dependent on specific development features?  (Project development information found [https://wiki.openmrs.org/display/docs/Step+by+Step+Installation+for+Developers here])
+
# Development Features - Is the class dependent on specific development features?  (Project development information found [https://wiki.openmrs.org/display/docs/Step+by+Step+Installation+for+Developers here])
##Programming language - What is the primary language?
+
## Programming language - What is the primary language?
##Development environment - What environments are supported?   
+
## Development environment - What environments are supported?   
##Supporting technologies - What technologies are suggested/required?
+
## Supporting technologies - What technologies are suggested/required?
  
=== Deliverables: ===
+
=== Deliverables ===
Wiki posting of evaluation of a project from the [http://www.foss2serve.org/index.php/HFOSS_Communities list of HFOSS projects]
+
  
 +
POSSE: On your user wiki page, a section describing your evaluation of OpenMRS as a suitable project for your course.
  
=== Assessment: ===
+
= Notes for Instructors =
How will the activity be graded?
+
+
How will learning will be measured?
+
  
Include sample assessment questions/rubrics.
+
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?
 +
* Include sample assessment questions/rubrics.
  
 
{| border="1" class="wikitable"
 
{| border="1" class="wikitable"
Line 143: Line 154:
 
|}
 
|}
  
=== Comments: ===
+
=== Comments ===
What should the instructor know before using this activity?
+
  
What are some likely difficulties that an instructor may encounter 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?
  
=== Variants and Adaptations: ===
+
=== Variants and Adaptations ===
[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]] at UPenn in his [[FOSS_Course_Syllabus|Full FOSS Course]]
+
  
=== Additional Information: ===
+
[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]].
A list of projects that may be of interest can be found at:
+
[http://www.foss2serve.org/index.php/HFOSS_Projects List of HFOSS projects]
+
  
Read the [http://foss2serve.org/images/foss2serve/a/ac/Evaluating_FOSS_Projects.docx SIGCSE paper on evaluating FOSS projects]
+
=== Additional Information ===
  
Or watch these videos introducing the FOSS project evaluation criteria:
+
* Explore this list of [[HFOSS Projects]] that may be of interest.
#[http://youtu.be/MAGet2D5o2c Mission critical criteria]
+
* Read the [http://foss2serve.org/images/foss2serve/a/ac/Evaluating_FOSS_Projects.docx SIGCSE paper on evaluating FOSS projects]
#[http://youtu.be/e4lnIXjqczU Secondary criteria]
+
* Watch these videos introducing the FOSS project evaluation criteria:
 +
*# [http://youtu.be/MAGet2D5o2c Mission critical criteria]
 +
*# [http://youtu.be/e4lnIXjqczU Secondary criteria]
  
=== Additional Information: ===
+
{{Learning Activity Info
{| border="1"
+
|acm unit=
|-
+
|acm topic=
|'''ACM Knowledge Area/Knowledge Unit''' || What ACM Computing Curricula 2013 knowledge area and units does this activity cover? [[ACM_Body_of_Knowledge]]
+
|difficulty=
|-
+
|time=
|'''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
+
60-90 minutes.
|-
+
<span style="color:#FF0000">This activity can take a significant amount of time. We only expect you to spend 60-90 minutes exploring.</span>  
|'''Level of Difficulty''' || Is this activity easy, medium or challenging?
+
You may not complete the activity within this time. Of course you are welcome to spend more time if you wish.
|-
+
|environment=
|'''Estimated Time to Completion''' || 60-90 minutes <span style="color:#FF0000">This activity can take a significant amount of time. We only expect you to spend 60-90 minutes exploring.</span> You may not complete the activity within this time. Of course you are welcome to spend more time if you wish.
+
* Access to Internet/Web and web browser
|-
+
* [[Media:Evaluating_FOSS_Projects.docx | SIGCSE paper on evaluating FOSS projects]]
|'''Materials/Environment''' || Access to Internet/Web and web browser, [[Media:Evaluating_FOSS_Projects.docx | SIGCSE paper on evaluating FOSS projects]][http://www.foss2serve.org/images/foss2serve/0/0c/Blank_Evaluation_Template.xlsx Blank evaluation template]
+
* [http://www.foss2serve.org/images/foss2serve/0/0c/Blank_Evaluation_Template.xlsx Blank evaluation template referred to in the SIGCSE paper]
|-
+
|author=
|'''Author''' || Who wrote this activity?
+
Michele Purcell
|-
+
|source=
|'''Source''' || N/A
+
|license=
|-
+
{{License CC BY SA}}
|'''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.
 
--------------------
 
This work is licensed under a
 
[http://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0 International License]
 
 
[[File:CC_license.png]]
 
  
  
[[Category: Learning_Activity]]
+
[[Category:Instructor Activities]]
[[Category:Use_and_Evaluate]]
+
[[Category:Learning Activity]]
 +
[[Category:Use and Evaluate]]
 +
[[Category: Good Draft]]

Latest revision as of 17:44, 8 March 2017

This activity has been revised. The newer version is here

Title

Evaluate a Project

Overview

Learners will gain an understanding of the breadth of available HFOSS projects. Learners will also gain an understanding of the identifying characteristics of HFOSS projects including pattern of contributions, patterns of commits, programming languages used, and more.

Prerequisites
  • Completion of FOSS Field Trip (Activity) or understanding of SourceForge and OpenHub; Understanding of the course in which students will be participating in an HFOSS project.
Learning
Objectives
After successfully completing this activity, the learner should be able to:
  • Identify likely HFOSS projects.
Process Skills
Practiced


Background

This activity is intended to give you an overview of what to consider when evaluating an HFOSS project for student participation and for you to gain experience using the rubric.

Directions

Walk through of an evaluation of the OpenMRS project

There are many criteria which should be looked at when determining if a project is appropriate to use in your class. These criteria are broken into two groups - mission critical and secondary. For this exercise, the secondary criteria are optional.

Mission Critical Criteria - Viability
  1. Size/Scale/Complexity - An ideal project should be neither overly simple nor overly complex.
    1. Go to the OpenMRS web page (http://openmrs.org/), scroll to the bottom and choose OpenMRS Wiki (under Other OpenMRS sites). From the menu on the left expand the Developer Guide and the Getting Started as a Developer options and then choose Technical Overview. From examination of the technology stack, the architecture looks modular and further search shows it is documented elsewhere on the site. This provides a first look at the complexity of the application and the number and various different technologies involved.
    2. Based upon the results from OpenHub (gathered in the FOSS Field Trip activity) and the information from the OpenMRS Technical Overview page, think about the size of the code base and how many different technologies and layers are involved in the application. What would you score this project for size/scale/complexity on a scale of one to three where one is "low" and three is "high".
  2. Activity - To support student participation a project should be reasonably active. Number of commits can be used as an indicator of activity.
    1. Based upon the number of commits (gathered in the FOSS Field Trip activity) would you consider this project active? Why or why not?
  3. Community - A suitable project has an active user community. While it is difficult to quantitatively evaluate the activity of a user community, some indicators include a regular history of project downloads and documentation updates over time, current activity on user mailing lists, and testimonials on the project web site.
    1. Examine download activity
      1. Go to sourceforge.net and enter OpenMRS into the search box.
      2. Choose OpenMRS from the search results.
      3. Click on the number of downloads that is listed on the project page.
      4. Change the date range to give a graph of downloads over the last year.
    2. OpenMRS has begun migrating legacy mailing list activity to OpenMRS Talk. Examine discussion activity
    3. Examine the IRC logs
    4. Based upon the download history, discussion activity, and IRC activity, do you feel this project has a good community? Why or why not?
Mission Critical Criteria - Approachability
Here you are evaluating a project's on-ramp to contribution, scoring as follows:
1 - Insufficient - Few or no pointers on how to become involved.
2 - Sufficient - Suggestions about how to get involved other than contributing money with accompanying high-level instructions.
3 - Ideal - Obvious link to get started, list of suggestions for things to do and detailed instructions.
  1. Examine project on-ramp.
    1. Link to getting started - The website has a Get Involved page with links to ways you can contribute and share your ideas.
    2. Each of the links (Develop, Test, Document, Translate) contain more detailed information about what and how you can contribute.
    3. The Getting Started as a Developer page contains a detailed list of how to get started including a list of introductory issues.
    4. Detailed instructions - The Developer Guide contains instructions and information in many areas including process, architecture, tools, and developer documentation.
    5. Based upon the resources you looked at, how would you rate the approachability of the OpenMRS project?


Mission Critical Criteria-Suitability
  1. Appropriate Artifacts - Since evaluation is dependent on class objectives, in this example we'll assume the objective is to learn the process of working in an authentic development environment by contributing bug fixes to OpenMRS.
    1. Opportunities to contribute bug fixes - Examine the issues found at the bottom of the getting started as a developer page. How are the introductory issues categorized? How many issues are listed?
    2. Documentation on how to contribute bug fixes - On the Tickets page there is information on how to create and work on an issue, including links to coding standards and the code submission process. Review this information.
    3. Based upon the number of bugs suitable for students to tackle and information on the process of how to submit bug fixes, do you think this would be an appropriate project for your students? Why or why not?
  2. Contributor Support - Does the project have a high volume of guidance to help students as they learn?
    1. Communication Tools - Communication tools are directly available from any of the Wiki Spaces (Documentation, Projects, Resources). The Resources page contains links to OpenMRS Talk and IRC Chat, as well as links to group meetings (under Events), and training opportunities.
    2. Web Presence - Examine the IRC logs. Has there been activity during the last week?
    3. Operating Processes - Links to information about coding standards, the code submission process, and commit privileges can be found on the How-To Submit Code page. The process for making feature requests is available on the Tickets page. Are these processes well documented?
    4. Response to Questions - Review a few of the posts on the OpenMRS discussion platform. Do posts to this forum receive timely and supportive responses?
    5. How would you rate the support that newcomers to OpenMRS receive?


On your wiki page, write a summary of why you think the OpenMRS project would be suitable for your course. Be sure to include information about the course and reasons why OpenMRS would be a good/poor match.


Overall evaluation for Mission Critical criteria - If the mission-critical criteria seemed reasonable, then you may want to evaluate the following secondary criteria. If the mission-critical was not reasonable then the project would not be considered suitable for student participation.


Secondary Criteria - Viability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment
  1. Domain
    1. Does this project require domain knowledge that may be difficult for students to learn? OpenMRS is a medical records system. Students should be able to grasp it well enough to contribute a bug fix, which is the learning objective assumed in this example.
    2. How would you rate the understandability of OpenMRS?
  2. Maturity
    1. To have the organization support student learning, the project should have at least one stable production release. The Platform Release Notes page lists releases.
    2. Does OpenMRS have enough of a stable base to support student learning? Why or why not?
  3. User Support
    1. The project should have clear instructions for downloading, installing, and using the project. As noted previously, the Getting Started as a Developer page provides detailed information about setting up and using the required tools, in addition there are detailed instructions related to installation, configuration, system requirements, and troubleshooting, including videos.
    2. Does the documentation seem sufficient for getting students started?
  4. Roadmap
    1. Student learning is best supported by projects that have a roadmap that includes new feature development, a method for users to submit new feature requests and a process for identifying how new features are prioritized. Feature requests are made through JIRA, the OpenMRS issue tracker. Road map planning and the process for prioritizing feature requests is available on the Technical Roadmap Planning page. Here you will find information about the planning process and how to participate in the planning process. The Technical Road Map page identifies features, their current status, and a point of contact, in addition to expected dates of completion.
    2. Does the roadmap provide you with enough information to make a decision about using it in your course?


Secondary Criteria - Approachability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment
  1. Contribution Types
    1. Does the project contain opportunities for multiple types of contribution and of the type that fits the class? There are multiple projects for testers, tech writers, and developers. These can be seen on the Get Involved page. Are the number of and type of bugs available suitable for students given your course and the class size? Are there other ways that students could contribute?
  2. Openness to Contributions
    1. Acceptance of a student contribution to a project provides valuable affirmation to student learning. Determine whether the project accepts student patches. The process for contribution is documented on the Tickets page. Does this project seem likely to accept student contributions?
  3. Student Friendliness
    1. Do community members moderate the tone of communication? Review the discussion platform and IRC to gauge tone. Review the discussion platform and IRC logs. What was the tone of the communication?


Secondary Criteria - Suitability - Secondary criteria sections are OPTIONAL for the POSSE workshop assignment
  1. Project Description
    1. Students must be able to understand the purpose of the project. Does the project clearly describe the product? Can students understand the intended uses of the product? - The About page provides an overview of who, where, and what OpenMRS is, including a downloadable PDF file and a video.
  2. Platform
    1. What software and hardware platform does the FOSS project run on? Development environment can be built on Windows, Linux or Mac OS X completely with FOSS software. (Project development information found here)
    2. Are there resources to support these platforms?
    3. Are students familiar with the platforms?
  3. Development Features - Is the class dependent on specific development features? (Project development information found here)
    1. Programming language - What is the primary language?
    2. Development environment - What environments are supported?
    3. Supporting technologies - What technologies are suggested/required?

Deliverables

POSSE: On your user wiki page, a section describing your evaluation of OpenMRS as a suitable project for your course.

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?
  • Include sample assessment questions/rubrics.
Criteria Level 1 (fail) Level 2 (pass) Level 3 (good) Level 4 (exceptional)
The purpose of the project
Why the project is open source

Comments

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

Variants and Adaptations

POGIL-style combined FOSS Field Trip and Project Evaluation used by Chris Murphy in his FOSS Course, UPenn, Murphy.

Additional Information

ACM BoK
Area & Unit(s)
ACM BoK
Topic(s)
Difficulty
Estimated Time
to Complete

60-90 minutes. This activity can take a significant amount of time. We only expect you to spend 60-90 minutes exploring. You may not complete the activity within this time. Of course you are welcome to spend more time if you wish.

Environment /
Materials
Author(s)

Michele Purcell

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