User:KNarayan
m |
|||
(94 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | + | = Krish Narayanan = | |
Krish Narayanan is a professor in the Department of Computer Science at Eastern Michigan University. She also serves as the undergraduate advisor in the department, a faculty fellow in the Honors College, and the faculty advisor for Women in CS club. She teaches both undergraduate and graduate courses, ranging from Intro to Programming to Advanced Database Systems. Her teaching and research interests are in the areas of databases and software engineering, with a focus on design. She has been actively involved in CS education over the past few years. | Krish Narayanan is a professor in the Department of Computer Science at Eastern Michigan University. She also serves as the undergraduate advisor in the department, a faculty fellow in the Honors College, and the faculty advisor for Women in CS club. She teaches both undergraduate and graduate courses, ranging from Intro to Programming to Advanced Database Systems. Her teaching and research interests are in the areas of databases and software engineering, with a focus on design. She has been actively involved in CS education over the past few years. | ||
Line 13: | Line 13: | ||
==== Intro to Wikis ==== | ==== Intro to Wikis ==== | ||
− | 1. How do people interact? | + | 1. How do people interact? Just like other IM interactions. |
− | Just like other IM interactions. | + | |
− | 2. What is the pattern of communication? | + | 2. What is the pattern of communication? People in the chat room can communicate with all or with individual users. They can also issue IRC commands like /help. |
− | + | ||
− | 3. Are there any terms that seem to have special meaning? | + | 3. Are there any terms that seem to have special meaning? Any text prefixed with # is a MeetBot command. |
− | + | ||
− | 4. What advantages might IRC have over other real-time communication methods (like Google Chat or Facebook Messenger?) Are there potential disadvantages? | + | 4. What advantages might IRC have over other real-time communication methods (like Google Chat or Facebook Messenger?) Are there potential disadvantages? Looks and feels techie! MeetBot and other services are a plus. |
− | + | ||
− | 5. Can you make any other observations? | + | 5. Can you make any other observations? The MeetBot summarizes the meeting pretty well. I understand that it is more work for the meeting chair but it is worth the trouble. |
− | + | ||
− | + | 6. Bonus question: Why didn't Heidi and Darci's actions get picked up by the meetbot? A username is case-sensitive. The MeetBot looks for usernames in interactions for action assignments. | |
− | 6. Bonus question: Why didn't Heidi and Darci's actions get picked up by the meetbot? | + | |
− | + | ||
==== Sample HFOSS projects ==== | ==== Sample HFOSS projects ==== | ||
− | + | '''[https://www.sugarlabs.org/ SugarLabs]''' | |
− | [https://www.sugarlabs.org/ SugarLabs | + | |
* computer use in education (K-12) | * computer use in education (K-12) | ||
* many roles, such as, educator, developer, designer, translator | * many roles, such as, educator, developer, designer, translator | ||
Line 39: | Line 36: | ||
* last push in March 2014! | * last push in March 2014! | ||
− | + | '''[http://eden.sahanafoundation.org/wiki SahanaEden]''' | |
− | [http://eden.sahanafoundation.org/wiki SahanaEden | + | |
* humanitarian platform for solutions to disaster management, development, environmental management | * humanitarian platform for solutions to disaster management, development, environmental management | ||
* many roles, such as, devloper, tester, translator, designer, GIS specialist | * many roles, such as, devloper, tester, translator, designer, GIS specialist | ||
Line 47: | Line 43: | ||
* last active ticket in 2015 | * last active ticket in 2015 | ||
− | + | '''[http://openmrs.org/ OpenMRS]''' | |
− | [http://openmrs.org/ OpenMRS | + | * Open Hub project since 2007 |
+ | * a platform to store medical records for healthcare | ||
+ | * initial adoption in Kenya | ||
+ | * targeted towards non-programmers to help them customize a solution to their needs | ||
+ | * mostly Java-based with some JavaScript | ||
+ | * last commit was in August 2016 | ||
==== FOSS project hosting ==== | ==== FOSS project hosting ==== | ||
− | + | '''[https://sourceforge.net/ SourceForge]''' | |
− | [https://sourceforge.net/ SourceForge | + | |
− | ==== | + | A search for "Education" on the website and further refining the search to "Puzzle Games" resulted in 227 projects. There are 65 Java, 59 C++, 27 Python projects included and many more. Each project has a status associated with it, such as, stable, alpha, planning, etc. These indicate the stage of the development cycle they are in. For example, ''FindThatWord'' is in beta testing while ''FS.WordFinder'' is in production. The projects can be sorted using different criteria, such as, last updated, most popular, and rating. ''Brain workshop'' seems to be the most popular wheres ''Ohod Quiz Game'' seems to be the last updated. |
− | [https:// | + | |
+ | I liked these projects: | ||
+ | * Brain Workshop | ||
+ | * IncrediBots | ||
+ | * Sudokuki | ||
+ | * Build your own jeopardy | ||
+ | * Brain speed test | ||
+ | |||
+ | ''Brain Workshop'' is a Python project implementing a popular brain exercise. It is obvious from the reviews that anyone interested in mental exercises would like this app. There are 5 committers to the project. The last update was in August 2015. This is not a suitable project for contribution since it is well in production. There doesn't seem to be many maintenance/change requests. | ||
+ | |||
+ | '''[https://www.openhub.net/ OpenHub]''' | ||
+ | |||
+ | ''OpenMRS'' is a moderately active project which was analyzed 26 days ago based on code collected 3 months ago. It is mostly written in Java. It is written in 15 languages, such as, JavaScript, XML, and Perl. It has 3.73 million LOC. The top three committers to the project have been active for the last 3-5 years. The average number of contributors in the last twelve months is around 10. The average number of commits in the past 12 months is around 30. | ||
+ | |||
+ | ''Mousetrap'' is another interesting project which provides a simple library for handling keyboard shortcuts in Javascript. | ||
+ | |||
+ | ==== Walkthrough of OpenMRS ==== | ||
+ | '''Mission-critical criteria : Viability''' | ||
+ | |||
+ | # Size/Scale/Complexity: A closer look at [https://wiki.openmrs.org/display/docs/Technical+Overview OpenMRS's architecture] shows that a number of different tools and technologies are in play here. With over 3 million LOC and the use of multiple programming languages, I would rate this project a 3 on a scale of 1 to 3 for its size/scale/complexity. The high rating is warranted considering the small projects that students are usually working on in CS classrooms. The use of MVC pattern, Spring framework, Hibernate for object-relational mapping, and MySQL is a good blend of different technologies that students in our curriculum have been exposed to in a CS classes. It would be a good learning experience for them to bring them all together in one application. | ||
+ | # Activity: An average of 30 commits per month seems to be reasonably good for an active project. | ||
+ | # Community: OpenMRS seems to be an active project with over 950 downloads and releases as late as in August 2016. The community seems to be actively involved in OpenMRSTalk and IRC and constantly pushing updates. This kind of a community would encourage students to be actively involved, contribute, and learn. Here are some resources. [https://wiki.openmrs.org/display/RES/Home Resources page] [https://botbot.me/freenode/openmrs/ IRC logs] [https://talk.openmrs.org/ discussion platform] [https://wiki.openmrs.org/display/docs/Tickets Tickets page] [https://wiki.openmrs.org/display/docs/How-To+Submit+Code How-To Submit Code page] | ||
+ | # Domain: | ||
+ | # Maturity: | ||
+ | # User support: | ||
+ | # Roadmap: | ||
+ | |||
+ | '''Mission-critical criteria : Approachability''' | ||
+ | |||
+ | # Project on-ramp: The project has a wealth of documentation on how one could get on-board and start contributing. The [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer developer guide] provides a wealth of information regarding how to get started, a database of past issues and how they were solved, current issues one could contribute to, and other useful resources. I would rate the approachability of this project very high. | ||
+ | # Contributor types: | ||
+ | # Openness to contributions: | ||
+ | # Student friendliness: | ||
+ | |||
+ | '''Mission-critical criteria : Suitability''' | ||
+ | |||
+ | # Appropriate artifacts: Browsing the section on introductory issues on the [https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer developers guide] shows that issues are classified as ''bug fixes'', ''task'', ''improvement'' and ''new feature''. There are a total of 71 issues listed. The [https://wiki.openmrs.org/display/docs/Tickets tickets] page list a step-by-step process for creating new issues (new features or bugs). It also lists a similar process to work on issues. These issues seem something students can work on. They have all the necessary information to get started and the issues seem to involve a manageable amount of time and effort to leave the students with a sense of contribution to a big project. | ||
+ | # Contributor support: In addition to the above resources, the [https://wiki.openmrs.org/display/RES/Home resources page] and [https://wiki.openmrs.org/display/docs/How-To+Submit+Code how to submit code page] provide all the necessary support for new comers to the project. Guidelines for code submission, coding standards and commit privileges are also provided. I would rate the contributor support for this project very high. | ||
+ | # Project description: | ||
+ | # Platform: | ||
+ | # Development features: | ||
+ | |||
+ | '''Overall evaluation of OpenMRS for a course''' | ||
+ | |||
+ | A careful evaluation of the project shows that it is a good fit for student's capstone experience in a CS curriculum. It provides exposure to a number of technologies, a large-scale project, team work, and a substantial support for students. | ||
==== FOSS in a class ==== | ==== FOSS in a class ==== | ||
+ | There are a number of ways to contribute to a FOSS project, including, writing and fixing code, analyzing code, modifying code to meet standards and conventions, prototyping and designing solutions, adding documentation, creating blog posts, updating wikis, doing historical and other related research, providing feedback and reviews, using and evaluating software releases, reporting bugs, responding to queries, learning to interact with a community, teaching others, investigating software licensing, understanding privacy/security issues and their applications, packaging and distribution of software, fundraising, brainstorming new features and enhancements, and helping with installation and other adoption issues. These are just a few of the many different options discussed in the following resources. | ||
+ | * [http://blog.smartbear.com/programming/14-ways-to-contribute-to-open-source-without-being-a-programming-genius-or-a-rock-star/ 14 Ways to Contribute to Open Source without Being a Programming Genius or a Rock Star] | ||
+ | * [https://icontribute.wordpress.com/how-to-contribute-to-open-source-without-coding/ How to Contribute to Open Source Without Coding] | ||
+ | * [http://foss2serve.org/index.php/50_Ways 50 Ways to be a FOSSER] | ||
+ | Below is a collection of resources to help with creating course content for a FOSS class. This content was copied from [[FOSS in Courses 1 (Instructors)]] | ||
+ | * There is a set of [[:Category:Learning Activity|Learning Activities]], most of which are introductory assignments, on this wiki. This learning activity itself is part of that set. You'll find it under the "education" sub-category. | ||
+ | * TeachingOpenSource has a [http://teachingopensource.org/index.php/Teaching_Materials_Catalogue Teaching Materials Catalog] that contains examples of courses and a few individual assignments. | ||
+ | <!--## There is an [http://www.xcitegroup.org/softhum/doku.php?id=f:wnecsefa10 case study] of a software engineering course where students make contributions to HFOSS projects. The course used a series of [http://www.xcitegroup.org/softhum/doku.php?id=f:templates document templates and rubrics]. --> | ||
+ | * Steve Jacobs at RIT has a [http://teachingopensource.org/index.php/RIT/The_Course Open Source Course]. | ||
+ | * Seneca College has a [http://zenit.senecac.on.ca/wiki/index.php/Main_Page Center for Open Source Technology] that has links to courses that utilize FOSS. | ||
+ | * Rensselaer Polytechnic Institute also has a [https://rcos.io/ Center for Open Source Software]. | ||
+ | I am interested in using [[:Category:OpenMRS|OpenMRS]] for my class project. I would likely start my students off with the following activities before contributing code: | ||
+ | * Researching the project | ||
+ | * Lurking in the IRC channels | ||
+ | * Asking questions about ongoing project activities | ||
+ | * Shadowing a contributor | ||
+ | * Writing blogs/wikis | ||
+ | * Downloading and installing the latest release | ||
+ | * Providing experience reports on using the software | ||
+ | * Submitting a bug report | ||
+ | |||
+ | I am considering a new FOSS class. ideally, I would like students to be able to contribute to a project at many different levels. The above list includes activities that do not require software development skills. I would like to spend at least a third of the semester on such activities and then have students contribute to the code base for the rest of the semester. The latter contribution would be a small-group effort and would mimic a CS capstone course with the exception of an ongoing, large, geographically distributed, well-defined, well-understood (by the students), and well-supported software development project. | ||
+ | |||
+ | ==== Bug Tracker Activity ==== | ||
+ | |||
+ | '''Bug reports''' | ||
+ | |||
+ | The [https://bugzilla.gnome.org/ GNOME Bugzilla] has a collection of bugs reported by users and developers. An advanced search shows that the following are used to describe bus/issues. | ||
+ | * ID - a 6-digit identifier | ||
+ | * Sev - Severity, ranging from critical to trivial | ||
+ | * Pri - Priority, ranging from immediate to low | ||
+ | * OS - Operating system | ||
+ | * Product - name of the entity associated with the bug, such as, gnome-panel | ||
+ | * Status - status of the bug in the lifecycle, ranging from unconfirmed to verified | ||
+ | * Resolution - the final decision on a bug report, such as, duplicate, obsolete, etc | ||
+ | * Summary - short description of the bug | ||
+ | |||
+ | The bug report shows a list of bugs, ordered by status, with uncommitted ones at the top. These bugs then transition to new, assigned, needinfo, resolve, and unverified. Base on the severity of these bug reports, they are color coded. Red implies critical, black represents normal, and grey represents enhancement. | ||
+ | |||
+ | A bug that I can contribute to is [https://bugzilla.gnome.org/show_bug.cgi?id=769452 here]. This "new" bug was submitted in Aug 2016 and has not been assigned yet. It seems to report missing information in the GNOME user documentation - gnome-help. The bug reporter includes the pages in which the license agreement do not show up and also provides a patch to fix this bug. How difficult can this be! | ||
+ | |||
+ | Another bug that caught my attention is [https://bugzilla.gnome.org/show_bug.cgi?id=769956 here]. I am not sure if I could fix this, but it seems to be an interesting problem that cropped up after an update of a supposedly unrelated functionality. The problem seems to be with gnome-screenshot taking 100% of a cpu time. The bug reporter includes a bunch of components that were updated. This may be a difficult task to track and might have been a problem with regression testing or lack therof. | ||
+ | |||
+ | '''Collective reports''' | ||
+ | [https://bugzilla.gnome.org/page.cgi?id=weekly-bug-summary.html Weekly bug summary] for the week of Nov 7th, 2016 show the following: | ||
+ | * No of opened reports = 308 | ||
+ | * No of closed reports = 268 | ||
+ | * The top three bug closers were Michael, Milan, and Alexandre. These are probably the active contributors to the project at this point in time. | ||
+ | * The top three bug reporters were Piotr, Bob, and Phillip. These three contributors could be working on the QA aspect of the project. They don't seem to bug closers. | ||
+ | * There doesn't seem to be much of an overlap between the above two lists. | ||
+ | * The top three patch contributors were Phillip, George and Ignacio. There is at least one person on this list that is also a patch reviewer. But, for the most part these lists seem to be non-overlapping. | ||
+ | * There seems to be one bug reporter who also submitted a patch. | ||
+ | |||
+ | The [https://bugzilla.gnome.org/query.cgi?format=report-graph generate graphical reports page] allows you to generate a wide variety of reports, on different parameters, such as, severity, number of components, resolution. You could generate a bar graph, line graph or pie chart on the data. | ||
+ | The [https://bugzilla.gnome.org/report.cgi?y_axis_field=bug_severity&cumulate=0&z_axis_field=&format=bar&x_axis_field=component&no_redirect=1&query_format=report-graph&short_desc_type=allwordssubstr&short_desc=&product=orca&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_id=&bug_id_type=anyexact&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&emailtype3=substring&email3=&chfieldvalue=&chfieldfrom=&chfieldto=Now&j_top=AND&f1=noop&o1=noop&v1=&action=wrap graphical report] for Orca reveals that the component named "braile" had 0 major bugs, 19 normal bugs, 0 minor bugs, and 10 enhancements. | ||
+ | |||
+ | ==== FOSS in a class - round 2==== | ||
+ | |||
+ | The class I am planning to use FOSS will be a new, upper-level undergraduate class. At EMU, we are allowed to cross-list classes between UG and graduate programs. So, the course would be attended by UG seniors and graduate students. I would expect students to to have experiences in advanced programming concepts, data structures and algorithms. I am questioning whether this course should have the software engineering course as a co-requisite. The two courses could supplement each other. If I decide to go with this idea, I would make all projects in this course individual ones. If not, I will have small group projects. | ||
+ | |||
+ | I would probably use one or both of the following as textbook(s) for the class: | ||
+ | * [https://www.amazon.com/Producing-Open-Source-Software-Successful/dp/0596007590/ref=sr_1_2?s=books&ie=UTF8&qid=1479140066&sr=1-2&keywords=open+source+software Carl Fogel's Producing Open Source Software] | ||
+ | * [https://www.amazon.com/Producing-Open-Source-Software-Successful/dp/0596007590/ref=sr_1_2?s=books&ie=UTF8&qid=1479140066&sr=1-2&keywords=open+source+software Eric Raymond's Cathedral and the Bazaar] | ||
+ | Lectures would be based on the book contents. Readings and group discussions are possible options too. | ||
+ | |||
+ | Initially, would get students started with non-programming activities to get them to experience open source development. These activities could involve the following: | ||
+ | * Researching a FOSS project | ||
+ | * Lurking in the IRC channels | ||
+ | * Asking questions about ongoing project activities | ||
+ | * Shadowing a contributor | ||
+ | * Writing blogs/wikis | ||
+ | * Downloading and installing the latest release | ||
+ | * Providing experience reports on using the software | ||
+ | * Submitting a bug report | ||
+ | I would expect this initial exploratory phase to take about a third of the semester. I hope to have classroom discussions based on student experiences. | ||
+ | |||
+ | For the rest of the semester, I will have students contribute to code, through bug fixes, patches, new feature development, and such. This is going to involve significant time and effort on my part to research ahead of time and develop meaningful assignments for the students. It should include firm deadlines and deliverables till the end of the semester. It would be nice to have the community that the students are contributing code to, to provide feedback. | ||
+ | |||
+ | I plan to use the following resources for course planning: | ||
+ | * [http://foss2serve.org/index.php/FOSS_Course_Syllabus Chris Murphy's FOSS course] | ||
+ | * [http://mars.wne.edu/~hellis/CS490/syllabus.html Heidi Ellis's Software Engineering course] | ||
+ | * [http://www.cs.rpi.edu//~moorthy/Courses/CSCI2961-01-Fall2016/ RPI's Open Source Software course] | ||
+ | * [http://mars.wne.edu/~hellis/CS490/syllabus.html CMU's Software Engineering Practicum course with an open source option] | ||
+ | * [http://cs412.gkt.cs.luc.edu/ Loyola University Chicago's Open Source Practicum course] | ||
== '''POSSE Stage 2 Activities - Workshop''' == | == '''POSSE Stage 2 Activities - Workshop''' == | ||
== '''POSSE Stage 3 Activities - Post-workshop''' == | == '''POSSE Stage 3 Activities - Post-workshop''' == | ||
+ | |||
+ | |||
+ | [[Category:POSSE 2016-11]] |
Latest revision as of 01:09, 7 February 2017
Contents |
Krish Narayanan
Krish Narayanan is a professor in the Department of Computer Science at Eastern Michigan University. She also serves as the undergraduate advisor in the department, a faculty fellow in the Honors College, and the faculty advisor for Women in CS club. She teaches both undergraduate and graduate courses, ranging from Intro to Programming to Advanced Database Systems. Her teaching and research interests are in the areas of databases and software engineering, with a focus on design. She has been actively involved in CS education over the past few years.
In her spare time, she teaches computer science to kids, especially middle and high school girls (Girls in Computing). She has been an avid Science Olympiad coach/supervisor for many years. She runs an event called iCompute for an elementary science olympiad. She has coached a few Girls in Computing teams to compete at the EMU High School Programming competition.
Check out Krish's blog
POSSE Stage 1 Activities - Pre-workshop
Intro to Wikis
1. How do people interact? Just like other IM interactions.
2. What is the pattern of communication? People in the chat room can communicate with all or with individual users. They can also issue IRC commands like /help.
3. Are there any terms that seem to have special meaning? Any text prefixed with # is a MeetBot command.
4. What advantages might IRC have over other real-time communication methods (like Google Chat or Facebook Messenger?) Are there potential disadvantages? Looks and feels techie! MeetBot and other services are a plus.
5. Can you make any other observations? The MeetBot summarizes the meeting pretty well. I understand that it is more work for the meeting chair but it is worth the trouble.
6. Bonus question: Why didn't Heidi and Darci's actions get picked up by the meetbot? A username is case-sensitive. The MeetBot looks for usernames in interactions for action assignments.
Sample HFOSS projects
- computer use in education (K-12)
- many roles, such as, educator, developer, designer, translator
- coding in Python, JavaScript
- base module is called Glucose
- base activity modules are called Fructose
- Google Summer of Code
- last push in March 2014!
- humanitarian platform for solutions to disaster management, development, environmental management
- many roles, such as, devloper, tester, translator, designer, GIS specialist
- coding in Python, JavaScript, SQLite
- Communication through Google Groups, IRC, mail lists
- last active ticket in 2015
- Open Hub project since 2007
- a platform to store medical records for healthcare
- initial adoption in Kenya
- targeted towards non-programmers to help them customize a solution to their needs
- mostly Java-based with some JavaScript
- last commit was in August 2016
FOSS project hosting
A search for "Education" on the website and further refining the search to "Puzzle Games" resulted in 227 projects. There are 65 Java, 59 C++, 27 Python projects included and many more. Each project has a status associated with it, such as, stable, alpha, planning, etc. These indicate the stage of the development cycle they are in. For example, FindThatWord is in beta testing while FS.WordFinder is in production. The projects can be sorted using different criteria, such as, last updated, most popular, and rating. Brain workshop seems to be the most popular wheres Ohod Quiz Game seems to be the last updated.
I liked these projects:
- Brain Workshop
- IncrediBots
- Sudokuki
- Build your own jeopardy
- Brain speed test
Brain Workshop is a Python project implementing a popular brain exercise. It is obvious from the reviews that anyone interested in mental exercises would like this app. There are 5 committers to the project. The last update was in August 2015. This is not a suitable project for contribution since it is well in production. There doesn't seem to be many maintenance/change requests.
OpenMRS is a moderately active project which was analyzed 26 days ago based on code collected 3 months ago. It is mostly written in Java. It is written in 15 languages, such as, JavaScript, XML, and Perl. It has 3.73 million LOC. The top three committers to the project have been active for the last 3-5 years. The average number of contributors in the last twelve months is around 10. The average number of commits in the past 12 months is around 30.
Mousetrap is another interesting project which provides a simple library for handling keyboard shortcuts in Javascript.
Walkthrough of OpenMRS
Mission-critical criteria : Viability
- Size/Scale/Complexity: A closer look at OpenMRS's architecture shows that a number of different tools and technologies are in play here. With over 3 million LOC and the use of multiple programming languages, I would rate this project a 3 on a scale of 1 to 3 for its size/scale/complexity. The high rating is warranted considering the small projects that students are usually working on in CS classrooms. The use of MVC pattern, Spring framework, Hibernate for object-relational mapping, and MySQL is a good blend of different technologies that students in our curriculum have been exposed to in a CS classes. It would be a good learning experience for them to bring them all together in one application.
- Activity: An average of 30 commits per month seems to be reasonably good for an active project.
- Community: OpenMRS seems to be an active project with over 950 downloads and releases as late as in August 2016. The community seems to be actively involved in OpenMRSTalk and IRC and constantly pushing updates. This kind of a community would encourage students to be actively involved, contribute, and learn. Here are some resources. Resources page IRC logs discussion platform Tickets page How-To Submit Code page
- Domain:
- Maturity:
- User support:
- Roadmap:
Mission-critical criteria : Approachability
- Project on-ramp: The project has a wealth of documentation on how one could get on-board and start contributing. The developer guide provides a wealth of information regarding how to get started, a database of past issues and how they were solved, current issues one could contribute to, and other useful resources. I would rate the approachability of this project very high.
- Contributor types:
- Openness to contributions:
- Student friendliness:
Mission-critical criteria : Suitability
- Appropriate artifacts: Browsing the section on introductory issues on the developers guide shows that issues are classified as bug fixes, task, improvement and new feature. There are a total of 71 issues listed. The tickets page list a step-by-step process for creating new issues (new features or bugs). It also lists a similar process to work on issues. These issues seem something students can work on. They have all the necessary information to get started and the issues seem to involve a manageable amount of time and effort to leave the students with a sense of contribution to a big project.
- Contributor support: In addition to the above resources, the resources page and how to submit code page provide all the necessary support for new comers to the project. Guidelines for code submission, coding standards and commit privileges are also provided. I would rate the contributor support for this project very high.
- Project description:
- Platform:
- Development features:
Overall evaluation of OpenMRS for a course
A careful evaluation of the project shows that it is a good fit for student's capstone experience in a CS curriculum. It provides exposure to a number of technologies, a large-scale project, team work, and a substantial support for students.
FOSS in a class
There are a number of ways to contribute to a FOSS project, including, writing and fixing code, analyzing code, modifying code to meet standards and conventions, prototyping and designing solutions, adding documentation, creating blog posts, updating wikis, doing historical and other related research, providing feedback and reviews, using and evaluating software releases, reporting bugs, responding to queries, learning to interact with a community, teaching others, investigating software licensing, understanding privacy/security issues and their applications, packaging and distribution of software, fundraising, brainstorming new features and enhancements, and helping with installation and other adoption issues. These are just a few of the many different options discussed in the following resources.
- 14 Ways to Contribute to Open Source without Being a Programming Genius or a Rock Star
- How to Contribute to Open Source Without Coding
- 50 Ways to be a FOSSER
Below is a collection of resources to help with creating course content for a FOSS class. This content was copied from FOSS in Courses 1 (Instructors)
- There is a set of Learning Activities, most of which are introductory assignments, on this wiki. This learning activity itself is part of that set. You'll find it under the "education" sub-category.
- TeachingOpenSource has a Teaching Materials Catalog that contains examples of courses and a few individual assignments.
- Steve Jacobs at RIT has a Open Source Course.
- Seneca College has a Center for Open Source Technology that has links to courses that utilize FOSS.
- Rensselaer Polytechnic Institute also has a Center for Open Source Software.
I am interested in using OpenMRS for my class project. I would likely start my students off with the following activities before contributing code:
- Researching the project
- Lurking in the IRC channels
- Asking questions about ongoing project activities
- Shadowing a contributor
- Writing blogs/wikis
- Downloading and installing the latest release
- Providing experience reports on using the software
- Submitting a bug report
I am considering a new FOSS class. ideally, I would like students to be able to contribute to a project at many different levels. The above list includes activities that do not require software development skills. I would like to spend at least a third of the semester on such activities and then have students contribute to the code base for the rest of the semester. The latter contribution would be a small-group effort and would mimic a CS capstone course with the exception of an ongoing, large, geographically distributed, well-defined, well-understood (by the students), and well-supported software development project.
Bug Tracker Activity
Bug reports
The GNOME Bugzilla has a collection of bugs reported by users and developers. An advanced search shows that the following are used to describe bus/issues.
- ID - a 6-digit identifier
- Sev - Severity, ranging from critical to trivial
- Pri - Priority, ranging from immediate to low
- OS - Operating system
- Product - name of the entity associated with the bug, such as, gnome-panel
- Status - status of the bug in the lifecycle, ranging from unconfirmed to verified
- Resolution - the final decision on a bug report, such as, duplicate, obsolete, etc
- Summary - short description of the bug
The bug report shows a list of bugs, ordered by status, with uncommitted ones at the top. These bugs then transition to new, assigned, needinfo, resolve, and unverified. Base on the severity of these bug reports, they are color coded. Red implies critical, black represents normal, and grey represents enhancement.
A bug that I can contribute to is here. This "new" bug was submitted in Aug 2016 and has not been assigned yet. It seems to report missing information in the GNOME user documentation - gnome-help. The bug reporter includes the pages in which the license agreement do not show up and also provides a patch to fix this bug. How difficult can this be!
Another bug that caught my attention is here. I am not sure if I could fix this, but it seems to be an interesting problem that cropped up after an update of a supposedly unrelated functionality. The problem seems to be with gnome-screenshot taking 100% of a cpu time. The bug reporter includes a bunch of components that were updated. This may be a difficult task to track and might have been a problem with regression testing or lack therof.
Collective reports Weekly bug summary for the week of Nov 7th, 2016 show the following:
- No of opened reports = 308
- No of closed reports = 268
- The top three bug closers were Michael, Milan, and Alexandre. These are probably the active contributors to the project at this point in time.
- The top three bug reporters were Piotr, Bob, and Phillip. These three contributors could be working on the QA aspect of the project. They don't seem to bug closers.
- There doesn't seem to be much of an overlap between the above two lists.
- The top three patch contributors were Phillip, George and Ignacio. There is at least one person on this list that is also a patch reviewer. But, for the most part these lists seem to be non-overlapping.
- There seems to be one bug reporter who also submitted a patch.
The generate graphical reports page allows you to generate a wide variety of reports, on different parameters, such as, severity, number of components, resolution. You could generate a bar graph, line graph or pie chart on the data. The graphical report for Orca reveals that the component named "braile" had 0 major bugs, 19 normal bugs, 0 minor bugs, and 10 enhancements.
FOSS in a class - round 2
The class I am planning to use FOSS will be a new, upper-level undergraduate class. At EMU, we are allowed to cross-list classes between UG and graduate programs. So, the course would be attended by UG seniors and graduate students. I would expect students to to have experiences in advanced programming concepts, data structures and algorithms. I am questioning whether this course should have the software engineering course as a co-requisite. The two courses could supplement each other. If I decide to go with this idea, I would make all projects in this course individual ones. If not, I will have small group projects.
I would probably use one or both of the following as textbook(s) for the class:
Lectures would be based on the book contents. Readings and group discussions are possible options too.
Initially, would get students started with non-programming activities to get them to experience open source development. These activities could involve the following:
- Researching a FOSS project
- Lurking in the IRC channels
- Asking questions about ongoing project activities
- Shadowing a contributor
- Writing blogs/wikis
- Downloading and installing the latest release
- Providing experience reports on using the software
- Submitting a bug report
I would expect this initial exploratory phase to take about a third of the semester. I hope to have classroom discussions based on student experiences.
For the rest of the semester, I will have students contribute to code, through bug fixes, patches, new feature development, and such. This is going to involve significant time and effort on my part to research ahead of time and develop meaningful assignments for the students. It should include firm deadlines and deliverables till the end of the semester. It would be nice to have the community that the students are contributing code to, to provide feedback.
I plan to use the following resources for course planning:
- Chris Murphy's FOSS course
- Heidi Ellis's Software Engineering course
- RPI's Open Source Software course
- CMU's Software Engineering Practicum course with an open source option
- Loyola University Chicago's Open Source Practicum course