bootstrapworld / curriculum

6 stars 7 forks source link

Convert Alignment one pagers to asciidocs and adjust wording / css so that pdf versions look great. #613

Closed flannery-denny closed 3 years ago

flannery-denny commented 3 years ago
flannery-denny commented 3 years ago

@retabak made a little headway on this

  1. sounds like Emmanuel wants us to prioritize im alignment pages. lmk when yours are ready for feedback & if you need help converting them to asciidocs (these files are a little more complicated because they have multiple programming languages in them because of all the css...)
  2. look forward to feedback re: which lesson descriptions work and don't
  3. look forward to feedback re: which images you think are good enough and which I need to find / make better ones for.

To avoid confusion: we're on the master branch git pull then ./build-pathway __sample --book -Fto see updated materials.

retabak commented 3 years ago

Some thoughts as I've been working through these one-pagers:

@schanzer - I don't know the CS standards well enough to know: do we want the CS standards that we list out to remain the same, no matter what grade level the one-pager is designed for? I'm assuming maybe yes (we offer essentially the same curriculum to all grade level teachers, allowing them to customize) - but maybe we want to tweak these standards a little for each grade level? (If I'm way off track here, just tell me that the one sentence is fine for all grades!)

flannery-denny commented 3 years ago

@retabak I got your message about wanting a uniform size. I think I'm fine with that. The original template Emmanuel made used rem0.8 and many of the pages only had one line on the second page. They're not as egregious since I adjusted them to rem1. That said, I think it's worth considering adjusting image sizes and prose used as a way of making the pages closer to full.

Are you working on making the new images you suggest or are you asking for help with making them?

I will look at the wording for Linear Relationships and see if I can improve upon it.

I am pretty sure that the CS standards should correspond to the lessons we're referencing & not be one size fits all! I bet @schanzer could update lists for each of these 6 files pretty easily.

I don't think we can link to CMP lessons. Teachers can only access them if they pay for access. .Is IM free or do teachers need a log in to access materials?

(And, side note, what I was trying to say about CMP alignment in our meeting yesterday is that CMP is on its third edition and the units have moved around from one grade to another as standards have shifted, so, teachers who've been teaching for a bit think of the units not the grades. Also, CMPs materials go deep and most teachers aren't able to do all of the units or at least not all parts of all the units, so don't think of them as being numbered the way that you think about IM)

retabak commented 3 years ago
retabak commented 3 years ago

I spent WAY too much time messing with these PDF files. I'm done (!) / ready for others to take a look.

A few questions....

I think they look pretty nice!

schanzer commented 3 years ago

@retabak

@flannery-denny

flannery-denny commented 3 years ago

CMP 8th grade and algebra are almost identical, just one extra unit, so I included it in the 8th grade alignment. Pretty sure that people who use CMP to teach algebra are middle school teachers.

On Wed, Oct 6, 2021 at 10:04 PM retabak @.***> wrote:

I spent WAY too much time messing with these PDF files. I'm done (!) / ready for others to take a look.

A few questions....

  • @flannery-denny https://github.com/flannery-denny @schanzer https://github.com/schanzer "linear relationships" and "defining linear relationships" are only in the Oklahoma pathway! Should we be advertising those particular lessons on these one-pagers?
  • Noticed that CMP3 has an algebra (high school) curriculum, too. Do we care to have a one-pager for that? Or.... too late, forget about it? I did grades 6, 7, 8 and Algebra 1 (largely because Nick did a lot of Algebra 1 alignment work this summer).
  • I do wish that the content for grade 8 and HS filled a bit more of the first page but ran out of ideas (or I'm braindead now).

I think they look pretty nice!

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/bootstrapworld/curriculum/issues/613#issuecomment-937405430, or unsubscribe https://github.com/notifications/unsubscribe-auth/AP4Z7TE7U4O3FHQ5DYVYMTTUFUE3JANCNFSM5FBKX3IA .

flannery-denny commented 3 years ago

@retabak You have repeatedly emphasize the importance of numbering things. I am surprised to see the the units you list on these one-pagers come without numbers. Curious how you arrived at that decision?

flannery-denny commented 3 years ago

I am noticing that on the two-page version of this document the only logo on the back is the NSF logo. Wondering whether we also want the Bootstrap logo to appear somewhere on the back of the page.

flannery-denny commented 3 years ago

@retabak I like the images on the 6th grade IM page, and appreciate that they are not all the same width. The game image you're using seems to be lower res than the rest. Curious whether you've played around at all with including images for each of the Bootstrap lessons referenced. It would result in much less white space on the back of the page. I don't have a strong preference here. Just noting the choice you're making.

flannery-denny commented 3 years ago

@schanzer is there an easy way to adjust the vertical alignment of the images that we are including? I am looking at the 7th grade IM file and I think it would look better if we moved the dog down in first box.

flannery-denny commented 3 years ago

@retabak. I don't know the IM materials well enough to know whether the words you're using for scale drawings (im7) make sense. In CMP there are several huge projects that involve sketching scaled images that these words were referring to.

retabak commented 3 years ago

@Flannery Denny [she - her] @.***> - I experimented with this! I think I can just insert the @link directive into a lower row of text, like between two bullets. (There was another instance where I was able to successfully do this.) I'll play with it.

On Thu, Oct 7, 2021 at 12:14 PM flannery-denny @.***> wrote:

@schanzer https://github.com/schanzer is there an easy way to adjust the vertical alignment of the images that we are including? I am looking at the 7th grade IM file and I think it would look better if we moved the dog down in first box.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/bootstrapworld/curriculum/issues/613#issuecomment-937942688, or unsubscribe https://github.com/notifications/unsubscribe-auth/AUY3SE2OUW3RB25FYIXTRG3UFXBOVANCNFSM5FBKX3IA . Triage notifications on the go with GitHub Mobile for iOS https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Android https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub.

schanzer commented 3 years ago

@retabak took the words right out of my mouth. :)

flannery-denny commented 3 years ago

@retabak the words you're using for Making Shapes from Code in IM7 talk about CMP3.

Also, I like the way the images you've chosen look, but I'm curious whether there are others you can think of that might tell a clearer story about how our materials connect to math learning goals? They do not appear to relate to the unit title.

flannery-denny commented 3 years ago

@retabak I am curious why you decided to go to a single pie-chart for probability and sampling. The image I had made was designed to highlight the ease of making comparisons described in the text. Do you think the image I'm using doesn't read well and I should change it for CMP? Is the comparison less important to IM materials and you should change the text here?

flannery-denny commented 3 years ago

@schanzer confirming that it's on your to do list to make sure that each of these 7 files have the correct CS Standards at the top? Currently, I am seeing the same standards on pages for different grades.

schanzer commented 3 years ago

@flannery-denny I hadn't planned on it, no. See this comment.

flannery-denny commented 3 years ago

@retabak I don't love that all of the images for IM 8 are the same width... and I'm not sure I love the white background on Bootstrap Rocks. Want me to try to make it transparent? I like the image you picked for scatterplots and wonder if we could get a clearer one where it's easier to read the words.

I adjusted the wording in Function Composition and Alice's Restaurant slightly. See if it makes more sense to you now.

schanzer commented 3 years ago

@flannery-denny we seem to be of different opinions when it comes to images being a consistent size. My reasoning is that visual consistency is a good thing, especially when we have a pre-existing vertical alignment due to the table columns. It's weird for me to see consistency on the left, and inconsistency on the right. I'm not setting a hard rule, either -- I just think we should aim for consistency when we're a few pixels away from it.

You seem to take a harder, opposite posion. What's your reason for preferring that none of the images have consistent sizes?

flannery-denny commented 3 years ago

@schanzer Here are two styles for side by side comparison.
Screen Shot 2021-10-07 at 11 47 15 AM Screen Shot 2021-10-07 at 11 47 22 AM I think the page with images with uniform width is boring and rigid... and, more importantly, making the width uniform draws my eye to what's inconsistent and asymmetrical about the included images. Rachel only made one page that way. But I don't really care. If you'd rather she change the other pages, direct away.

schanzer commented 3 years ago

@flannery-denny I think what's boring about the first page is that the images are mostly-white, and all rectangles. The second image has entirely uniform widths, with the exception of the green star - and I don't think removing that star makes the page any less boring!

Let's try and keep these uniform - but only where it makes sense and can be done easily.

flannery-denny commented 3 years ago

@schanzer How important is it to you that they all end up the same width?

The image widths on that first page are totally different from the image widths on the second page. If we were to make the images from one page width match the other page width, images would either be fuzzy or details would be illegible because they'd be too small.

And if you look at Grade 6, some of the images are landscape and some are portrait.

Screen Shot 2021-10-07 at 12 24 46 PM

flannery-denny commented 3 years ago

@retabak I made a couple of transparent images and inserted them into IM8. I'm not sold, but they're there for you to play around with and make decisions about when you dig back in.

schanzer commented 3 years ago

@flannery-denny see this earlier comment. I'd like them to be the same width when it's easy -- like in the example on Rachel's page, where there was literally like 20 pixels of crop-able space.

flannery-denny commented 3 years ago

Thanks @schanzer. I'm handing it back to @retabak. Was just trying to clarify her target so that our collective efforts are as efficient as possible.

retabak commented 3 years ago

Thanks, y'all! Eager to dig through all this feedback.

On Thu, Oct 7, 2021 at 1:30 PM flannery-denny @.***> wrote:

Thanks @schanzer https://github.com/schanzer. I'm handing it back to @retabak https://github.com/retabak. Was just trying to clarify her target so that our collaborative efforts are as efficient as possible.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/bootstrapworld/curriculum/issues/613#issuecomment-938005557, or unsubscribe https://github.com/notifications/unsubscribe-auth/AUY3SE7ZB2TXSZLXYW7RDEDUFXKMPANCNFSM5FBKX3IA . Triage notifications on the go with GitHub Mobile for iOS https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Android https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub.

retabak commented 3 years ago

Whew, making these changes was very time-consuming and a little brain-numbing. Willing to respond to more feedback but - full disclosure - am pooped, did my best, sick of looking at these documents for now, you get the ida!

@flannery-denny

lol. I do love numbering! That said, the goal here is to help teachers see where they might infuse IM with bootstrap. We aren't suggesting a year-long, sequential series of lessons. It would be confusing to number, as some IM unit numbers would be skipped. Folks might think that these Bootstrap lessons had to go in this order.

I considered that but - to be honest - it is NOT easy to find appropriate, interesting, varied images! If you have any brilliant ideas for images to add, I would welcome them. That said, I feel like these pages are adequately spruced up with images.

Kids do need to draw various images to scale, but IM has no huge projects. Your comment prompted me to look at IM and see if the activity could be described as "arduous" and I think the answer is no. So, I will adjust the wording! Thanks.

The dog has been moved!

Woops! fixed.

I definitely considered this and decided I cared more that they looked nice. I did change the text to match more with what happens during this unit. (I definitely have never taught anything other than IM6, so have had to dig through their materials and learn much about the curriculum.

Full disclosure, I changed 2 pie charts to one because I didn't like empty space in the description box. That said, it had not occurred to me what you were trying to highlight -- it really just looked like 2 pie charts. I am relatively certain no one who views this document is analyzing the images with the level of scrutiny that we are applying. I think they're just going to think, "those look nice," or "oh cool, Bootstrap will help me kids produce things like this." The concept described in the text does apply to IM; sampling is a big focus of the CCSS grade 7 standards.

I'm not sure I can do any better than the scatterplot image that's in there. There was a black line along one side that I tried to edit out, it was a struggle. I suppose I could snip the image at a higher resolution if it feels really crucial?

I like it, thanks!

@schanzer

I zoomed a little but didn't want this page to bleed onto the next page. You get 20 more pixels, basically. I did my best!

I experimented with this and then decided I'm content with the spacing. Also, wow, this is tedious work. Braindead, need a break.

I played around with the images and am content as possible with how they are. If anyone has objections to a particular image, let me know and I'll change. I tried my best to respond to all concerns voiced.

flannery-denny commented 3 years ago

@schanzer - fyi - I have not been working on the cmp files at all because you said IM were the priority so I figured it was most efficient to get them how y'all want them to be and revise CMP after we'd nailed down IM.

flannery-denny commented 3 years ago

@schanzer - I remain confused by this statement

This is a math alignment document, not a CS alignment. Our goal with the CS content is to let people know we are aligned to them, but not necessarily which ones.

The text on the page says

These look like very specific standards.

If we just want people to know that we are aligned to some standards, then we should say that.

If we are going to declare that we are aligned to specific standards, the list should be correct.

It would be surprising to me if a list that is the same for all 4 grades is a list that's useful, but maybe CS standards and math standards work differently.

flannery-denny commented 3 years ago

@schanzer @retabak I am willing to sign off on the words on the IM one pagers (flagging that my above comment on the CS standards remains a concern, but I will defer to y'all on it.)

I am going to stay out of the final layout decisions for these because we seem to have too many cooks in the kitchen. I encourage you to force build before deciding if they're good to go, because what I'm seeing on my machine has big empty spaces, rows that appear to be broken, and non-transparent images that we have transparent versions of.

I will push CMP files for feedback soon.

retabak commented 3 years ago

I was happy with the version (before this most recent one) that had images with transparent backgrounds and also no big empty spaces / broken rows. (I think Emmanuel was experimenting with creating wider images to take up more space?) If we revert to the old version, I'm happy! And ready to look at CMP files.

On Mon, Oct 11, 2021 at 9:41 AM flannery-denny @.***> wrote:

@schanzer https://github.com/schanzer @retabak https://github.com/retabak I am willing to sign off on the words on the IM one pagers (flagging that my above comment on the CS standards remains a concern, but I will defer to y'all on it.)

I am going to stay out of the final layout decisions for these because we seem to have too many cooks in the kitchen. I encourage you to force build before deciding if they're good to go, because what I'm seeing on my machine has big empty spaces, rows that appear to be broken, and non-transparent images that we have transparent versions of.

I will push CMP files for feedback soon.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/bootstrapworld/curriculum/issues/613#issuecomment-940043639, or unsubscribe https://github.com/notifications/unsubscribe-auth/AUY3SEYDZS27I3CHNGV45V3UGLSRZANCNFSM5FBKX3IA . Triage notifications on the go with GitHub Mobile for iOS https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Android https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub.

flannery-denny commented 3 years ago

@schanzer @retabak I'm done with the cmp files & think they're ready for the world. If you have strong opinions on how things should be different in these files. Feel free to make the changes in the asciidocs.

Note: There are a lot of Bootstrap lessons with no CS standards listed!

schanzer commented 3 years ago

@retabak thanks for letting me know your thoughts about the changes. I'll revert them shortly.

@flannery-denny the pie-chart was given a white background by a CSS rule that I just removed.

Hopefully you won't get stuck dealing with much CSS in the future, but just in case....you can read that line as "inside the tbody (table body) element, grab the seventh tr (table row), and give any images inside a white background."

retabak commented 3 years ago

@flannery-denny lots of super nit-picky feedback for you! crap, I JUST SAW THAT YOU TOLD ME TO MAKE CHANGES IN ASCIIDOCS. I can take that on if you want (tomorrow). Maybe just let me know if there are any suggestions here you disagree with?

Grade 6, 7, and 8:

Grade 6:

Grade 7:

Grade 8:

flannery-denny commented 3 years ago

@schanzer I just checked out to a new branch to focus on if expressions lesson and don't want to put my head back into these one pagers until I've made some progress in that other universe. Assuming that since the urgency was around IM it's ok for me to tackle @retabak 's feedback next week or whenever I resurface from curriculum writing.

On Mon, Oct 11, 2021 at 3:19 PM retabak @.***> wrote:

@flannery-denny https://github.com/flannery-denny lots of super nit-picky feedback for you! crap, I JUST SAW THAT YOU TOLD ME TO MAKE CHANGES IN ASCIIDOCS. I can take that on if you want (tomorrow). Maybe just let me know if there are any suggestions here you disagree with?

Grade 6, 7, and 8:

  • left-hand column title should be CMP3, not just CMP (right? that's what's used everywhere else on these one-pagers)

Grade 6:

  • Yellow row: I get really lost in this very long sentence: "This lesson engages students in identifying the relevant dimensions for finding the area of each of the faces of the prism, generating a printable set of rectangles, labeled with their dimensions, from which students physically construct paper models of their own prisms and calculate the surface area." So many prepositions / clauses! I messed with this text in the IM version. (Screenshot below.) Do you like? If so, feel free to use. Otherwise, let's keep making it better! [image: image] https://user-images.githubusercontent.com/87144723/136847885-32b537ea-656a-444c-85ac-1e5489f60ea2.png
  • Orange row: In "simple code generates 5 number summaries", I think it should be "5-number summaries" (since those two words are serving as one adjective)
  • QUESTION! How did you get the circle of evaluation to look so nice! The transparency is rounded around the corners rather than at a hard 90-degree angle. Tell me your secrets and I'll fix the one I used for compound inequalities.

Grade 7:

  • Blue row: "two-dimensional geometry" needs a hyphen. (Double checked CMP3's site and they do it this way for sure!)
  • Blue row: Third bullet mentions "triangle contracts"; I don't think readers will know what that means,? On my grade 7 sheet, I wrote, "Students can use simple code to efficiently construct varying triangles of specified side lengths and angle measures." Maybe min can be better? Yours has more specificity. I just don't think we can throw around the word "contract."
  • Orange row needs proper bulleting. For some reason, the formatting didn't work.
  • Orange row: "Simple code allows students to experiment with scaling images (including shapes, their name, or any image from their google drive) up or down using scale factors and distorting images using scale-xy." By the time I finish the paranthetical, I've forgotten what the first half of the sentence says. Recommend splitting this into two sentences --> ""Simple code allows students to experiment with scaling images, including shapes, their name, or any image from their google drive. Students can use scale factors to increase or decrease the size, and they can distort images images using the function scale-xy." (Also not safe to assume folks know what "scale-xy" is.)
  • Purple row: I think "low-threshold and high-ceiling" is a misplaced modifier. (The way you have constructed the sentence, students are low-threshold and high-ceiling.") I changed it like this: [image: image] https://user-images.githubusercontent.com/87144723/136849125-5a3e8fee-51fa-44a4-8103-edc930c30bf4.png (Feel free to borrow or improve further! Let me know if you improve it.)
  • Pink row: I think the empty horizontal space looks a little odd since this is the only instance of it.
  • Turquoise row: "Three-Dimensional Measurement" should be hyphenated.
  • Turquoise row: This surface area image with the yellow halo still looks weird. I do not know how to fix, sadly, or if fixing is possible.
  • Turquoise row: same critique of surface area text as in Grade 6.

Grade 8:

  • Text at top of page says, "Teaching 7th grade math with BS addresses....." Needs to be changed to "8th grade math."
  • Blue row: Delete unneeded comment after "shapes"
  • Blue row: Rather than "etc", I'd rather you list out all the things that can be adjusted. (I'm not sure what would be on that list.)
  • Orange row: I like the other circle of evaluation image better (white on the inside) and also find it sharper/ easier to read.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/bootstrapworld/curriculum/issues/613#issuecomment-940413126, or unsubscribe https://github.com/notifications/unsubscribe-auth/AP4Z7TD4FKHFENDR2PWKCCTUGNBEZANCNFSM5FBKX3IA .

schanzer commented 3 years ago

@retabak @flannery-denny I've pushed two commits. The first tweaks spacing on all the pages in order to maximize the first page, filling it as much as possible. The second is an exploration of the high school CSTA standards, which gives us at least some CS-standards-differentiation between lessons. There's still a ton of overlap, but it's marginally better.

schanzer commented 3 years ago

These have shipped to Shriram and Kathi!