csc426: Open Source Software Engineering
Berea College
Final Presentations and Team Evaluation
- Our final evam period is Tuesday, 11:45 am. Please be sure to submit your slides in advance.
- Go to Team Evaluation to submit team evaluations this is due anytime on Friday.
- If you have not made any pull request for an issue that you want credit for in your project, you MUST do so so I can see your code! Be sure to do that any time Friday.
- Enjoy your break!
Day 27: Tuesday, December 5, 2023
Day 27: In class
Day 27: Before next class
- spend at least two hours outside of class making progress on your issue, keeping a record of your time in SR2: Project Time-Keeping and Scrum Report 2. In the same document write a scrum report and upload to Moodle before class. WARNING: Scrum reports will not be accepted late.
Day 26: Thursday, November 30, 2023
Day 26: In class
Day 26: Before next class
- spend at least four hours outside of class making progress on your issue, keeping a record of your time in SR1: Project Time-Keeping and Scrum Report 1. In the same document write a scrum report and upload to Moodle before class. WARNING: Scrum reports will not be accepted late.
Day 25: Tuesday, November 28, 2023
Day 25: In class
- Take Exam - this will likely take only half of the class period
- work on issues for the remainder of the class period
Day 25: Before next class
- spend at least two hours outside of class making progress on your issue
Thursday, November 23, 2023: No class - Thanksgiving Break
Day 24: Tuesday, November 21, 2023
Day 24: In class
Day 24: Before next class
- During class: Complete and submit the revised portion of PR Peerwise Review for Exam. Note that due to the nature of this assignment, it will not be accepted late.
- study for exam which will be on Tuesday, November 28
Day 23: Thursday, November 16, 2023
Day 23: In class
Day 23: Before next class
- Complete and submit the individual portion of PR Peerwise Review for Exam. Note that due to the nature of this assignment, it will not be accepted late.
- continue working on your issue
Day 22: Tuesday, November 14, 2023
Day 22: In class
- Discussions on readings and Runestone structure blog post.
- Short presentations on your chosen issue and your understanding of a portion of the Runestone codebase.
- work on our issues
Day 22: Before next class
- Spend two hours outside of class working on your issue. Be prepared to report on your progress next time.
Day 21: Thursday, November 9, 2023
Day 21: In class
- Discussions on readings and Blog post.
- Short presentations on your chosen issue and your understanding of a portion of the Runestone codebase.
- work on our issues
Day 21: Before next class
Day 20: Tuesday, November 7, 2023
Day 20: In class
- Read and discuss How to Navigate a Large Codebase Effectively
- We will explore different aspects of how Runestone works. This could be explore one of the servers or it could be explore the instructor interface or the author interface.
Day 20: Before next class
Optional class: Thursday, November 2, 2023
Optional class: In class
- Class is optional unless your environment is not yet working, then you are expected to attend.
Optional class: Before next class
- Your SOLE required homework is that you MUST get a working development environment with a book that builds and deploys inside of it asap but at the latest BEFORE class on Tuesday, November 7. You have ample resources. You have my office hours, which none of you have come to. You have Moise’s lab hours. You have both class times next week (which you can attend virtually if you are at AfroTech.) You have our Slack channel, the Runestone Discord channel, and you have all of the following video drop in times:
- Tuesday 3pm-5pm Eastern
- Wednesday 12noon-1:45pm Eastern
- Thursday 2pm-4pm Eastern
- Friday 3pm-5pm Eastern
- all of the above meet at the Zoom link: https://prose.runestone.academy/dropin/
If you REALLY cannot get your WSL set-up, you can set up a VM and run Ubuntu in it and set it up there.
But one way or another, I expect you to have a development environment fully set-up and fully working by BEFORE class on November 7.
Day 19: Tuesday, October 31, 2023
Day 19: In class
- Still fixing problems with the dev environment set-up.
Day 19: Before next class
- Your SOLE homework is that you MUST get a working development environment with a book that builds and deploys inside of it asap but at the latest BEFORE class on Tuesday, November 7. You have ample resources. You have my office hours, which none of you have come to. You have Moise’s lab hours. You have both class times next week (which you can attend virtually if you are at AfroTech.) You have our Slack channel, the Runestone Discord channel, and you have all of the following video drop in times:
- Friday 3pm-5pm Eastern
- Tuesday 3pm-5pm Eastern
- Wednesday 12noon-1:45pm Eastern
- Thursday 2pm-4pm Eastern
- all of the above meet at the Zoom link: https://prose.runestone.academy/dropin/
If you REALLY cannot get your WSL set-up, you can set up a VM and run Ubuntu in it and set it up there.
But one way or another, I expect you to have a development environment fully set-up and fully working by BEFORE class on November 7.
Day 18: Thursday, October 26, 2023
Day 18: In class
- Still fixing problems with the dev environment set-up. This cannot continue. Students, you MUST seek help, so the class can move forward! Ypu are also EXPECTED to communicate!!
We are going to break up into interest teams in class today.
1. Runestone Set-up: Two of the teams will explore some alternative Runestone set-ups for Brad Miller.
- “I would like to hear what others think is the best way for a newcomer trying to set up the servers to build a book. There are (at least) three different options that I can think of:
1. Install a production version of runestone from pypi
2. Initialize npm in bases/rsptx/interactives and use the dev version of runestone from the rs virtualenv.
3. Run docker compose run rsmanage rsmanage build bookname
Notes:
- You should not pip install things into the rs virtualenv so this would require a second virtualenv to swtich back and forth.
- This is what you need if you are actually going to do development on the components. But it is the most effort to get set up.
- The rsmanage docker container has a production version of runestone installed. Of all of them it should just work as long as you have an external or dockerized database running. Also, for ptx books this has the benefit of copying things into the right places, processing the manifest, and updating the library page.”
2. The rest of the teams will explore different aspects of how Runestone works. This could be explore one of the servers or it could be explore the instructor interface or the author interface.
All teams will be expected to report back to the class
Day 18: Before next class
- Your SOLE homework is that you MUST get a working development environment with a book that builds and deploys inside of it asap but at the latest BEFORE class on Tuesday, November 7. You have ample resources. You have my office hours, which none of you have come to. You have Moise’s lab hours. You have both class times next week (which you can attend virtually if you are at AfroTech.) You have our Slack channel, the Runestone Discord channel, and you have all of the following video drop in times:
- Friday 3pm-5pm Eastern
- Tuesday 3pm-5pm Eastern
- Wednesday 12noon-1:45pm Eastern
- Thursday 2pm-4pm Eastern
- all of the above meet at the Zoom link: https://prose.runestone.academy/dropin/
If you REALLY cannot get your WSL set-up, you can set up a VM and run Ubuntu in it and set it up there.
But one way or another, I expect you to have a development environment fully set-up and fully working by BEFORE class on November 7.
Day 17: Tuesday, October 24, 2023
Day 17: In class
- Discussion on Docker vs VMs
- More debugging of the Runestone build
Day 17: Before next class
- Homework: Try to get your build fully working and a book to build and deploy. If you are having trouble, please ask for help on our Slack channel, not in the Runestone Discord channel.
Day 16: Thursday, October 19, 2023
Day 16: In class
- Update your Windows by clicking the update from the web link. Note that this is important! Some of you ignored this before and it caused problems.
- Update your rs fork and update your local
- If on Windows and you haven’t done this already, go to Get started with Docker remote containers on WSL 2
- Report out on the Runestone setup and work-shopping set-up issues
- Strategizing about how to get unstuck
- If you get tired of all of the installation drugery, you can move on to learning about MVC and web2py:
Day 16: Before next class
Day 15: Tuesday, October 17, 2023
Day 15: In class
- Reporting out on the Runestone setup and work-shopping set-up issues
- Strategizing about how to get unstuck
Day 15: Before next class
- None - enjoy Mountain Day!
Day 14: Thursday, October 12, 2023
Day 14: In class
- Reporting out on the Runestone setup and work-shopping set-up issues
- Strategizing about how to get unstuck
- Possible work in opensource and cppds.
Day 14: Before next class
- None - study for your other midterm exams!
Day 13: Thursday, October 5, 2023
Day 13: In class
- Discuss documentation and contribution
- Discuss responding to comments
- Discuss outstanding pull-requests
- Discuss homework
- Revisit issues in opensource and cppds.
- Finish the complete indexing of the Pretext version of cppds being sure to index one entire file per pull-request and follow best practices.
Day 13: Before next class
- Carefully document your process on your blog as you very slowly and carefully follow the instructions to set up the development environment that begin at https://github.com/RunestoneInteractive/rs. For this you have a week, and I want you to demonstrate your understanding of the Runestone community by getting started on this early and seeking help appropriately in the appropriate Runestone communication channels. See Blog post description for more detail.
Day 12: Tuesday, October 3, 2023
Day 12: In class
- Run
pip install pretext --upgrade
- Discuss indexing in Pretext and Git workflow
- Revisit issues in opensource and cppds.
- Complete indexing of the Pretext version of cppds being sure to index one entire file per pull-request and follow best practices.
Day 12: Before next class
Day 11: Thursday, September 28, 2023
Day 11: In class
- Discuss open-source licensing
- Discuss indexing in Pretext and Git workflow
- Assigned expansion to other issues in specific sections of opensource and cppds.
Day 11: Before next class
Day 10: Tuesday, September 26, 2023
Day 10: In class
- Discuss the readings and the blog post on Agile
- Discuss strategies for figuring out how to create the index in a Pretext book
- Assigned expansion to other issues in specific sections of opensource and cppds.
Day 10: Before next class
Day 9: Thursday, September 21, 2023
Day 9: In class
- Git workflow. Update branches.
- Presentation by Ala Qasem
- Discuss a strategy to figure out how to create the index in a Pretext book
- Assigned expansion to other issues in specific sections of opensource
Day 9: Before next class
Day 8: Tuesday, September 19, 2023
Day 8: In class
Day : Before next class
Day 7: Thursday, September 14, 2023
Day 7: In class
Day 7: Before next class
Day 6: Tuesday, September 12, 2023
In class
- Discuss Dr. Miller’s visit, Runestone, and Runestone communication
- Top Priority Complete the pull requests begun last time in T02: Forking and Git Branches
- After completing your pull request, spend the remainder of the period giving feedback to the next
three two Github Pages websites on the 2023 course listing of websites (ignoring mine), and also posting a thoughtful comment on one of each of their blog posts. This means that everyone in the class should receive feedback on their website from three two people as well as thougthful comments on their blog from three two people.
Before next class
- Improve your Github Pages website based on feedback from classmates. (Can ypu also use AI to improve your website? Of course!)
- Respond to the comments received in your blog posts
Day 5: Thursday, September 7, 2023
Day 5: In class
Before next class
Day 4: Tuesday, September 5, 2023
In class
- Discuss chapter reading assignment and WSL
- Debug the use of VS Code with WSL
- Show and tell with Github pages websites
Meet with Dr. Brad Miller
Before next class*
- Post your Github pages website if you have not already done so.
- Post to your blog based on these prompts.
Day 3: Thursday, August 31, 2023
In class
Before next class
Day 2: Tuesday, August 29, 2023
In class
Before next class:
Day 1: Thursday, August 24, 2023
In class
- Welcome
- Discussion of course: content, texts, tools, syllabus, flow, etc
- Updating laptop in parallel with presentions
- Who is Dr. Jan Presentation
- Open Source Textbook: Runestone Academy - sign up for bc_opensource_f23
- CSC 426 Day 1 Slides which has many linked videos related to the course
Before next class
Copyright © 2023 | Licensed under a Creative Commons Attribution-Share Alike 3.0 United States License