jamesjuett / eecs280-async-lectures

MIT License
4 stars 2 forks source link

make sentence more concise and easier to understand #28

Open zalhabash opened 2 months ago

zalhabash commented 2 months ago

Let me know if you have any feedback on this suggestion.

closes #27

jamesjuett commented 1 month ago

In previous terms: Project 4 used to be implementing a linked list, then using it to build the backend for a web-based office hours queue. Project 5 used to be implementing a binary search tree, then using it to build a map.

This term: Project 4 is making the piazza-post classifier. Project 5 is implementing a linked list, then using it to build a text editor. (the web-based office hours queue part is gone) Project 6 is implementing a binary search tree, then using it to build a map.

Reading back through what I wrote, this isn't very clear (and I think I typo'ed P5 instead of P6 somewhere). For the long-term future of the async lectures, I wonder if it may be most clear to put something like:

"You may have heard that previous terms of EECS 280 had only 5 projects. We now have 6 projects, but the overall workload is the same - we've simply split one of the bigger projects into two pieces."

Or... eventually I'll update the video and can just talk about it there.

If you have any suggestions, feel free to update this PR.

zalhabash commented 1 month ago

I thought about this and completely forgot to reply.

I constantly try to learn/practice communicating more concisely, clearly, and effectively, especially in writing. I really enjoy editing my own and other people's writing when they welcome it. So with that in mind, I might be thinking too hard about this paragraph. 😂

In my perspective, I approach this by asking if the costs of more words are worth the benefits. Do students need to know fine details about how a project is changed? Will the gains from needs to read less potentially fluffy stuff to get to the meat of a lesson? Or are the benefits of transparency and clarity worth it?

I think the commit I made achieves both. It made the most important parts (the workload is not more, and get excited for a more interesting project) more concise. Then I put the nitty gritty of changes in a clear section that says what it is before you start reading it, so if some students don't need that information, they can skip/skim it.