- Brief reports on issue progress
- Remember that the Final Team Presentation will be in-person.
- 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.
- Discuss exam
- Discuss Final Portfolio
- Discuss Final Team Presentation. Should we do these via Teams or in-person? No hybrid options will be offered.
- Work on issues
- 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.
- Take Exam - this will likely take only half of the class period
- work on issues for the remainder of the class period
- spend at least two hours outside of class making progress on your issue
- Questions on upcoming exam
- Revise and submit PR Peerwise Review for Exam
- continue working on your issue
- 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
- Discussions and work on issues
- Begin PR Peerwise Review for Exam
- 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
- 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
- Spend two hours outside of class working on your issue. Be prepared to report on your progress next time.
- 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
- Go to Runestone structure blog post and follow the instructions there.
- 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.
- Complete readings and blog post. See Blog post description for more detail.
- Class is optional unless your environment is not yet working, then you are expected to attend.
- 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.
- Still fixing problems with the dev environment set-up.
- 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.
- 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 pypi2. 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 booknameNotes:- 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
- 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.
- Discussion on Docker vs VMs
- More debugging of the Runestone build
- 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.
- 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
- The directions include installing Docker Desktop for Windows. Once you have done that, I recommend the tutorials inside of Docker Desktop.
- If you have not done this already follow Get started with databases on Windows Subsystem for Linux: Postgresql
- 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:
- Complete See Blog post description for more detail.
- Reporting out on the Runestone setup and work-shopping set-up issues
- Strategizing about how to get unstuck
- None - enjoy Mountain Day!
- Reporting out on the Runestone setup and work-shopping set-up issues
- Strategizing about how to get unstuck
- Possible work in opensource and cppds.
- None - study for your other midterm exams!
- 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.
- 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.
- 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.
- Read Chapters 6 & 7: Documentation & Contribution Be sure to do all activities for participation credit.
- Discuss open-source licensing
- Discuss indexing in Pretext and Git workflow
- Assigned expansion to other issues in specific sections of opensource and cppds.
- Do the readings and the blog post on motivation
- 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.
- Read Chapter 5: Open Source Licensing Be sure to do all activities for participation credit.
- 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
- Do the readings and the blog post on Agile
- Discuss PreTeXt and the PreTeXt community
- Complete T03 Contributing and Accessibility
- Complete T03 Contributing and Accessibility if you didn't finish it in class.
- Discuss the feedback you got on your Github Pages website and blog posts
- Overview of PreTeXt
- Install the PreTeXt CLI as described in Section 5.2 PreTeXt CLI
- Fork the source code for this book then clone your fork to your WSL environment.
- Follow the instructions in Sections 5.2.3 and 5.2.4 to build and view the book.
- Complete the explorations and readings, explorations, and blog entry about Pretext that is described here.
- 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
threetwo 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 fromthreetwo people as well as thougthful comments on their blog fromthreetwo people.
- 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
- Discuss readings
- Using best practices as described in T02: Forking and Git Branches, contribute your link to our 2023 course listing of websites in order to make it look like the 2019 course listing of websites
- Meet with Dr. Brad Miller
- Complete the explorations and blog entry about Runestone that is described here.
- 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
- Post your Github pages website if you have not already done so.
- Post to your blog based on these prompts.
- Discuss reading assignment and Runestone
- CSC 426 Day 3 Slides
- Read Chapter 4: Version Control with Git Be sure to do all activities for participation credit.
- Complete your website and submit T01: Git and Personal Github Pages website. Be sure that by next time, you have at least a minimal at least locally, but should use HTML and CSS. Also be sure your Github pages site is set up even if you are having difficulty pushing to it. We will debug your use of WSL in the next class.
- Discuss reading assignment, Runestone, and blog assignment
- CSC 426 Day 2 Slides
Before next class:
- Complete the R2: Read Chapters 2 and 3 (OSS Community and Communication and OSS Development Environment) reading assignment
- Spend 30 minutes or so reading whatever interest you at the Runestone Academy Blog
- 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
- Complete the R1: Chapter 1: Introduction to Open Source Software reading assignment
- Set-up a blog for this course and write your first post.
- Submit link to blog in Moodle
- Post a big picture and a short bio to the csberea.slack.com #csc426 slack channel
- Be sure post your first post publicly and to ALSO copy post contents into Moodle