Open bitboxer opened 10 years ago
I basically agree with your criticism and suggestions. Especially the layout thing which we already discussed yesterday with a few coaches. Let's open issues for each topic and work on it.
Just want to point out that I don't find it to be that terrible that with this material learners need a lot of help. True, the material should be improved. Still, providing a lot of personal support while learning is an important aspect of how we run workshops and is more important to us than excellent material.
Thanks for the feedback! You basically addressed everything we discussed to change. The layout stuff is too much and also just...wrong. I'd say we restructure it a bit so the result will be a single-column layout that looks good. That way we can spare them of floats completely and avoid confusion about all the weird calculations you need to do with the box model.
I completely agree with the first steps thing: i saw some of them confused as to where to save files and so on. A clear path should exist for that so they can get through to what they really need to learn quickly.
I also agree with that the divide between project and preparation pages doesn't make much sense. We discussed this before the workshop, but like with everything else no one had time to address this and there was some dissent about it. I think it would be much nicer to not throw away anything on the go.
@xMartin the problem with bad material: the girls got confused and thought the problem was that they haven't understood it correctly. That leads to unnecessary frustration. We want them to have fun and a learning environment that removes as much frustration as possible. If we can't offer that the amount of people continuing this path will be not as many as it could (and should).
@bitboxer We're on the same page.
I've been busy trying to get a translatable version of this up online (so that german translations contributed don't just get left in the dust when its improved), but I'm hoping to work on the content soon as well.
I created a feedback form for the first day (html+css), here are the results: https://docs.google.com/spreadsheet/ccc?key=0AhBhpxgEmPGPdFB1R3hScjZYU2h6MDNzMkNNa2RUZXc&usp=sharing
Furthermore I also some points to optimize in future:
You need to explicit say what the reader has to do. At first it should say "open the text editor, create a new file".
Yep, my student had this problem, too.
Silly question: Why we don't use codecademy materials?
Silly question: Why we don't use codecademy materials?
The main reason, AFAIK is because our materials are generally tailored to being taught in a specific time period, in a workshop format. Whereas CodeAcademy is designed to be completed at someone's leisure and may take too long or be too short.
That is not to say one should immediately disregard all teaching materials around simply because they are not designed with OTS' primary teaching format in mind, if you think any would work well in a future session you should probably suggest that to your chapter and/or on discourse :)
@timaschew Thanks a lot for doing the feedback! About the coaches briefing: yes, that should be done. Seems it got lost in the organization. I thought we had it planned.
I tried this yesterday with some girls at the RailsGirls Workshop and after doing it with them I sadly must say: this tutorial needs serious work. The didactic behind it is not very good :sob: . They coudn't work on it for more than 10 minutes without help from a tutor.
Things I would love to see changed:
margin-left
,float
,list-style-type: none
...all in one step and explaining it all?! Why not something simple and step by step add stuff? And I really would removelist-style-type
from the first day of learning HTML.aside
,section
,navbar
...and all without real explanations...I would change this to a much much easier thing. Why not justp
,a
,h1
,div
? You can do lot's with that on your first day. And don't forget: don't add more than one unknown element into each example and explain it before adding the next one.display: inline
anddisplay:inline-block
,width: 44%
... as the first step learning HTML.clear: both
element is bad practice and should NEVER be teached. It breaks the "HTML should not contain elements that are needed for the style" rule. The better solution with the:after
element is the way to go. But I don't think this should be in the first day of learning HTML. As I said: dumb it down a little. You can do lot's of stuff with a few margins, colors, paddings and float left/right.