<div dir="ltr">+1 to screencast. I've found that in each open source techie org I work for, the instructions are completely different. And for those of us who don't use Git that often, it's quite confusing to know the best way forward -- especially when Github's own documentation is different from org documentation. <div>
<br></div><div>So, screencast would help determine the kinds of issues folks like Cassie have run into like "how should I be starting out by partitioning stuff" etc. </div><div><br></div><div>- Kat</div></div><div class="gmail_extra">
<br clear="all"><div><div dir="ltr"><div><a href="https://www.webmaker.org/" target="_blank">
</a>
<table style="font:14px/1.2 'Fira Sans','Open Sans',Helvetica,Arial,Sans-Serif!important">
<tbody><tr>
<td style="border-right:2px solid grey;padding:1em 1em 1em 0;text-align:center">
<a href="https://www.webmaker.org/" target="_blank">
<img src="http://stuff.webmaker.org/editorial-assets/unnamed.png" style="width:100px" alt="Mozilla Webmaker" height="100" width="100">
</a><br>
</td>
<td style="padding:1em 0 1em 1em"><b>
Kat Braybrooke</b><br>Curation & Co-Design Lead<br>Mozilla Foundation<br>
<br>
Email: <a href="mailto:kat@mozillafoundation.org" target="_blank">kat@mozillafoundation.org</a><br>
Twitter/IRC: <a href="https://twitter.com/codekat" target="_blank">@codekat</a><br>
Web: <a href="https://www.webmaker.org/" target="_blank">www.webmaker.org/teach</a></td></tr></tbody></table><br><a href="https://www.webmaker.org/" target="_blank"></a></div><span style="font-family:arial;font-size:small"></span></div>
</div>
<br><br><div class="gmail_quote">On Fri, Mar 7, 2014 at 8:22 AM, Cassie McDaniel <span dir="ltr"><<a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div style="word-wrap:break-word">That would definitely help.<div class=""><br><div>
<div style="text-indent:0px;letter-spacing:normal;font-variant:normal;text-align:-webkit-auto;font-style:normal;margin-bottom:0pt;font-weight:normal;line-height:1.15;text-transform:none;font-size:medium;white-space:normal;font-family:Helvetica;margin-top:0pt;word-spacing:0px">
<br><br style="line-height:normal"><span style="line-height:normal">Cassie McDaniel</span><br style="line-height:normal">Webmaker UX/UI Lead</div><div style="text-indent:0px;letter-spacing:normal;font-variant:normal;text-align:-webkit-auto;font-style:normal;margin-bottom:0pt;font-weight:normal;line-height:1.15;text-transform:none;font-size:medium;white-space:normal;font-family:Helvetica;margin-top:0pt;word-spacing:0px">
<a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a></div><div style="text-indent:0px;letter-spacing:normal;font-variant:normal;text-align:-webkit-auto;font-style:normal;margin-bottom:0pt;font-weight:normal;line-height:1.15;text-transform:none;font-size:medium;white-space:normal;font-family:Helvetica;margin-top:0pt;word-spacing:0px">
IRC & Twitter: cassiemc</div>
</div>
<br></div><div><div class="h5"><div><div>On 2014-03-07, at 11:22 AM, David Ascher <<a href="mailto:da@mozillafoundation.org" target="_blank">da@mozillafoundation.org</a>> wrote:</div><br><blockquote type="cite"><div style="word-wrap:break-word">
<p dir="ltr">Great user feedback!</p><p dir="ltr">I wonder if a screencast could help even if we can't simplify the steps. Would you have found that useful Cassie?<br>
</p>
<br><br><div class="gmail_quote">Cassie McDaniel <<a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a>> wrote:<blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
JP – thank you for so kindly pointing me in the right direction and being so supportive here! It really is very appreciated.<div><br></div><div>A few notes on what this was like for me, trying to use the install instructions from <a href="https://wiki.mozilla.org/Webmaker/Code/Dev/Environment#Option_3:_Installing_Webmaker_with_Vagrant" target="_blank">this link</a>. I only share not just to make myself look like an idiot, but to point out that this is SO hard for people just starting out. Makes me think it's not for me, which I know is not the intention.<br>
<div><ul><li>It's impossible to tell that Option 3 is for beginners. Is it? I'm still not sure! It sounds advanced because I don't know what Vagrant is.</li><li>The instructions say to download and install vagrant (I'm cool with that), then download Vagrantfile from github. Going to the github link, the documentation there says I need Vagrant AND VirtualBox. I'll download and install VirtualBox too, but I don't k
now why
the wiki didn't tell me to do that already. I worry I'm putting a whole bunch of bunff on my computer that I don't need.</li><li>Upon install, VirtualBox encourages me to create a new virtual machine (and won't let me exit out of that dialogue once I start it! A different problem, but still) Not sure if I have to do this in the interface or if it's included in the wiki instructions, so I'm not going to do anything with it right now.</li>
<li>Comparing the documentation is a huge hurdle for me. I want to make sure I'm doing it right – if the documentation were exactly the same on the wiki and in github, I would feel more confident in it and would be comfortable only looking at one set of instructions, saving me time and anxiety. =)</li>
<li>Aaaaand now I'm stuck. I actually don't know how to get past step 2. "Download the Vagrantfile from <a rel="nofollow" href="https://github.com/mozilla/webmaker-suite/tree/master/vagrant/localdev" target="_blank">https://github.com/mozilla/webmaker-suite/tree/master/vagrant/localdev</a> into a folder where you want to run your webmaker-suite VM from (ie, /Users/myuser/vagrant/webmaker-suite)" seems to me like 3 steps: I have to decide where I want to run my VM from – I have no idea, the example path doesn't really help me. Then I have to create that folder, then I download that link which I have no idea how to do. Or maybe I do know? Crisis of confidence.</li>
</ul></div><div>See you guys at GitClub in a bit.</div><div>Cassie</div><div><br></div><div><div><div style="font-family:Helvetica;font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;line-height:1.15;margin-top:0pt;margin-bottom:0pt">
<br style="line-height:normal"><span style="line-height:normal">Cassie McDaniel</span><br style="line-height:normal">Webmaker UX/UI Lead</div><div style="font-family:Helvetica;font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;line-height:1.15;margin-top:0pt;margin-bottom:0pt">
<a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a></div><div style="font-family:Helvetica;font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;line-height:1.15;margin-top:0pt;margin-bottom:0pt">
IRC & Twitter: cassiemc</div>
</div>
<br><div><div>On 2014-03-03, at 12:04 PM, John Schneider <<a href="mailto:johns@mozillafoundation.org" target="_blank">johns@mozillafoundation.org</a>> wrote:</div><br><blockquote type="cite">Cassie,<br><br>Typically, it is feasible to work on a single app (say, thimble), but often there are interdependent applications. For example, while working on thimble, you may need to login using Persona to test something...but that logging in process requires our login application. <br>
<br>Our apps are numerous, as documented here: <a href="https://dl.dropboxusercontent.com/u/2273146/Mofo%20Architecture.jpg" target="_blank">https://dl.dropboxusercontent.com/u/2273146/Mofo%20Architecture.jpg</a><br><br>
To make this requirement easier to get setup, we created a Vagrant box image with webmaker suite on it.<br><br><a href="https://wiki.mozilla.org/Webmaker/Code/Dev/Environment#Option_3:_Installing_Webmaker_with_Vagrant" target="_blank">https://wiki.mozilla.org/Webmaker/Code/Dev/Environment#Option_3:_Installing_Webmaker_with_Vagrant</a> is our rough draft on how you get Vagrant up and running with webmaker-suite (all the apps required). <br>
<br>Once you have completed those steps, you will have a local version of webmaker apps running. <br><br>Once you are to that point, hit me up for further details! Of course, if you have any questions, please let me know!<br>
<br>As you proceed, don't get frustrated! This is not really an "entry level" setup just yet, and your feedback will help me tune this to make it easier for folks starting off.<br><br>Thanks!<br>jp<br><br>
----- Original Message -----<br>
From: "Cassie McDaniel" <<a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a>><br>To: "JP Schneider" <<a href="mailto:john.p.schneider@gmail.com" target="_blank">john.p.schneider@gmail.com</a>><br>
Cc: "Kate Hudson" <<a href="mailto:kate@mozillafoundation.org" target="_blank">kate@mozillafoundation.org</a>>, "Webmaker dev" <<a href="mailto:webmaker-dev@mozilla.org" target="_blank">webmaker-dev@mozilla.org</a>>, "Ali Al Dallal" <<a href="mailto:alihuda2002@gmail.com" target="_blank">alihuda2002@gmail.com</a>>, "David Humphrey" <<a href="mailto:David.Humphrey@senecacollege.ca" target="_blank">David.Humphrey@senecacollege.ca</a>><br>
Sent: Monday, March 3, 2014 10:53:46 AM<br>Subject: Re: GitClub, was RE: Cassie on GitHub<br><br>I heart you guys. <br><br>It is true, I tried to get my environment set up last week, ran my first unassisted commands in Terminal, patted myself a bit on the back after installing Xcode and homebrew and all that jazz, then I eventually gave up. <br>
<br>I looked here and followed along fine: <a href="https://wiki.mozilla.org/Webmaker/Code/Dev/Environment" target="_blank">https://wiki.mozilla.org/Webmaker/Code/Dev/Environment</a> <br><br>But I found Webmaker Suite (here: <a href="https://github.com/mozilla/webmaker-suite#webmaker-suite-bootstrapinstallation-script" target="_blank">https://github.com/mozilla/webmaker-suite#webmaker-suite-bootstrapinstallation-script</a> ) a little more confusing. Was trying to compare the two lists of "pre-requisites" and they didn't quite match up. It was hard for me to know what I needed and what I didn't need, for example if I just wanted to work on <a href="http://webmaker.org/" target="_blank">webmaker.org</a> and not on the tools. Plus, what do I do next after I do have all that stuff installed? <br>
<br>Would be so so happy to have help. Chloe led a github for n00bs session last week too – she accidentally told me the wrong time so I didn't make it, but I would love to have a similar ongoing support group. Some of her gitclubbing resources here: <a href="https://openbadges.etherpad.mozilla.org/githubing" target="_blank">https://openbadges.etherpad.mozilla.org/githubing</a> <br>
<br>Cassie <br><br><br>Cassie McDaniel <br>Webmaker UX/UI Lead <br><a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a> <br>IRC & Twitter: cassiemc <br><br>On 2014-03-03, at 11:35 AM, JP Schneider < <a href="mailto:john.p.schneider@gmail.com" target="_blank">john.p.schneider@gmail.com</a> > wrote: <br>
<br><br><br><br>This is a decent github intro for designers a friend pointed me to: <br><a href="http://www.webdesignerdepot.com/2009/03/intro-to-git-for-web-designers/" target="_blank">http://www.webdesignerdepot.com/2009/03/intro-to-git-for-web-designers/</a> <br>
<br><br>On Mon, Mar 3, 2014 at 9:49 AM, JP Schneider < <a href="mailto:john.p.schneider@gmail.com" target="_blank">john.p.schneider@gmail.com</a> > wrote: <br><br><br><br>Cassie is right, we created newer easier ways to start developing on webmaker-suite, although i
t does
assume some familiarity with github at this point. <br><br>I am today going to be working on updating that readme to make it a bit more usable and digestible, and will send it over to you once complete Cassie! <br><br><br>
On Mon, Mar 3, 2014 at 9:46 AM, Kate Hudson < <a href="mailto:kate@mozillafoundation.org" target="_blank">kate@mozillafoundation.org</a> > wrote: <br><br><br><br>I’d also be happy to help. <br><br>Creating some kind of workshop or tutorial on git for designers has been on my future projects list for awhile, it would be great to see how this goes internally. <br>
<br>- K <br><br><br>On Mar 3, 2014, at 10:43 AM, Ali Al Dallal < <a href="mailto:alihuda2002@gmail.com" target="_blank">alihuda2002@gmail.com</a> > wrote: <br><br><br><br><br>I will be happy to join and help on this one as well. Not that I'm very expert, but I have learned a lot within my 9 months here and I think I can share some of my experience and get people started and lea
rn the
workflow on github <br><br>~Ali <br><br><br>On Mon, Mar 3, 2014 at 10:40 AM, David Humphrey < <a href="mailto:David.Humphrey@senecacollege.ca" target="_blank">David.Humphrey@senecacollege.ca</a> > wrote: <br><br><br>
<br>I'm not sure if there was any follow-up to this email, but I wanted to lend a voice of encouragement to this. <br><br>I was thinking about whether it might be useful to create a weekly or bi-weekly GitClub (patent pending on that name, btw...). What I mean by this is that I see lots of chatter around the foundation like this, where people want to get going on git and github. My experience teaching students to this is that it's a pretty steep vertical climb when you're beginning, and many people give up in frustration. <br>
<br>We could do a thing where we have a short show-and-tell, or all-questions-answered style thing on vidyo or irc on a regular basis, and people can ask questions or see short demos of things, without being made to feel dumb.
<br><br>If that's interesting, I'd be happy to lead some of them and get the ball rolling. <br><br>Dave <br><br><br>From: Webmaker-dev [ <a href="mailto:webmaker-dev-bounces@mozilla.org" target="_blank">webmaker-dev-bounces@mozilla.org</a> ] on behalf of Cassie McDaniel [ <a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a> ] <br>
Sent: Wednesday, February 26, 2014 5:53 PM <br>To: <a href="mailto:webmaker-dev@mozilla.org" target="_blank">webmaker-dev@mozilla.org</a> <br>Subject: Cassie on GitHub <br><br>Hello, <br><br>I'm determined. I'm committed. How I get set up so that I can contribute small design and text tweaks on stuff that you guys are building? <br>
<br>Any resources you guys know of for designers getting started with github? I am a pretty good test use case for a contributor starting from pretty much zero. Feel free to use me as such! <br><br>Related: Didn't JP make it a lot easier for us to share working prototypes on heroku? How does that
work?
<br><br>Thanks in advance, <br>Cassie-noob <br><br><br><br>Cassie McDaniel <br>Webmaker UX/UI Lead <br><a href="mailto:cassie@mozillafoundation.org" target="_blank">cassie@mozillafoundation.org</a> <br>IRC & Twitter: cassiemc <br>
<br><br>_______________________________________________ <br>Webmaker-dev mailing list <br><a href="mailto:Webmaker-dev@mozilla.org" target="_blank">Webmaker-dev@mozilla.org</a> <br><a href="https://mail.mozilla.org/listinfo/webmaker-dev" target="_blank">https://mail.mozilla.org/listinfo/webmaker-dev</a> <br>
<br><br>_______________________________________________ <br>Webmaker-dev mailing list <br><a href="mailto:Webmaker-dev@mozilla.org" target="_blank">Webmaker-dev@mozilla.org</a> <br><a href="https://mail.mozilla.org/listinfo/webmaker-dev" target="_blank">https://mail.mozilla.org/listinfo/webmaker-dev</a> <br>
<br><br>_______________________________________________ <br>Webmaker-dev mailing list <br><a href="mailto:Webmaker-dev@mozilla.org" target="_blank">Webmaker-dev@mozilla.org</a> <br><a href="https://mail.mozilla.org/listinfo/webmaker-dev" target="_blank">https://mail.mozilla.org/listinfo/webmaker-dev</a> <br>
<br><br><br><br><br>_______________________________________________<br>Webmaker-dev mailing list<br><a href="mailto:Webmaker-dev@mozilla.org" target="_blank">Webmaker-dev@mozilla.org</a><br><a href="https://mail.mozilla.org/listinfo/webmaker-dev" target="_blank">https://mail.mozilla.org/listinfo/webmaker-dev</a><br>
</blockquote></div><br></div></div><div style="margin-top:2.5em;margin-bottom:1em;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><br></div><pre><hr><br>Webmaker-dev mailing list<br><a href="mailto:Webmaker-dev@mozilla.org" target="_blank">Webmaker-dev@mozilla.org</a><br>
<a href="https://mail.mozilla.org/listinfo/webmaker-dev" target="_blank">https://mail.mozilla.org/listinfo/webmaker-dev</a><br></pre></blockquote></div><br>
-- david ascher</div></blockquote></div><br></div></div></div><br>_______________________________________________<br>
Webmaker-dev mailing list<br>
<a href="mailto:Webmaker-dev@mozilla.org">Webmaker-dev@mozilla.org</a><br>
<a href="https://mail.mozilla.org/listinfo/webmaker-dev" target="_blank">https://mail.mozilla.org/listinfo/webmaker-dev</a><br>
<br></blockquote></div><br></div>