dwyl / start-here Goto Github PK

add these links and text to the touch-typing section of the readme:

• BBC: http://www.bbc.co.uk/guides/z3c6tfr#zg8nsbk
• Typing Club: http://www.typingclub.com/typing-qwerty-en.html
  If you know/find a better (online) touch typing tutorial, please share it with us:
  https://github.com/dwyl/start-here/issues (thanks!)

As discussed in dwyl/summer#22 (comment)

To include:

• Text editor
  • Installing linter
  • Setting up tabs to spaces (2)
  • Column editing
  • 80 character line length guide
  • Syntax guide
• iTerm (and summary of why you would use more than one terminal window at once)

Exploring Expressions of Emotions in GitHub Commit Messages
http://geeksta.net/geeklog/exploring-expressions-emotions-github-commit-messages/

cc: @iteles @tsop14 😉

Hey! I think I good pinged in some notifications recently and totally want to get round to them but I'm not very good at finding my way through my notification history. Any suggestions on working out what I was supposed to be doing?

https://github.com/dwyl/start-here/tree/6cb32bda0f987dbbdc0889b4a64c74bfd91ac91a#who

A lot has happened since this readme was first authored! People finding dwyl will naturally gravitate to a repo called start-here so it should be a little more obvious what we do at dwyl in the first couple of sentences (and a clearer link to the manifesto).
I still love most of this, I think it just needs to be updated.

Reference: dwyl/print-me#14 (comment)

This would mean start-here helps people:

• Understand what dwyl is and what we do
• Understand how they can contribute
• Navigate our existing body of work quickly and easily without having to go through pages of repos on github
• Know where to start with coding

https://github.com/dwyl/start-here/blob/master/books-to-read.md

"SuggestdBy" as a key in the JSON - is this intentional? If not, maybe catch it now before it propagates?

so that you can open atom from the terminal e.g: atom .

otherwise you will see the error: -bash: atom: command not found

With the Atom open on your computer, Click Atom >> Install Shell Commands

You should expect to see:

Borrowed from: http://stackoverflow.com/a/23666354/1148249

I suggest that our _values_ should _not_ be a _static_ list, but instead each person who uses/builds a product with us, should be asked to rank their list of values/priorities (both) when they join (and periodically there after _people's priorities change_ ... we need to track this).

Linked to #28.

If you have 2 factor authentication (2FA) turned on, you'll need to use a personal token instead of a password if you log into git from the command line.

We need to have this documented somewhere if we plan to encourage 2FA.

In addition to everything being awesome, everything is also mutable.

We need to clearly define the process to changing things.
e.g. a decision that was made which we now have more/updated information on and needs re-visiting.

At first I tacked this onto the vim ticket, but I thought it would be better on it's own.

When someone is beginning to start working with the command line it is generally a pretty minimal experience. There are lot's of great endeavours to "bootstrap" defaults that can make it a much more enjoyable experience.

There is a great list here that outlines a lot of options for getting a leg up... http://dotfiles.github.io/

Perhaps this project may want to endeavour in creating it's own "dot-files" that people can adopt.

@iteles while reviewing the freelance agreement: https://github.com/dwyl/summer-2015/blob/9ee717657115de822916838833cab8d2ef9be9b7/freelance-agreement.md I noted an omission...
we need to craft our Definition of Done for dwyl.
There can be no ambiguity or imprecision in the language.
Please let me know when you have time this evening.

For others following along who are not familiar with this expression, please read:

• http://guide.agilealliance.org/guide/definition-of-done.html
• https://www.scrumalliance.org/community/articles/2008/september/what-is-definition-of-done-(dod)

While the @iteles notes on "The Good Parts" are great! Some people have found eloquent javascript quite useful: http://eloquentjavascript.net/ should we add it?

I've noticed @dwyl has choosen Vagrant to setup all their development environments.

I know Docker is a much different approach than Vagrant, but I was just wondering: could Docker tutorials be added to the readmes? For example, a short tutorial on how to setup ES with Docker.

You might say no because @dwyl would want to keep homogeneity of environments across all contributors by using the same Vagrantfile, and I would agree with that if special setups are needed. In case the answer is no, it might be interesting to add a note in this repo that Vagrant is prefered.

But in case of @docdis org, whose goal is to spread knowledge, it might be worthy adding Docker tutorials because it adds an alternative for newcomers to start off the tutorials, thus, reaching more people.

What do you think? /cc @nelsonic @iteles

@iteles @blossomica noted that the video has been taken down by youtube ... https://www.youtube.com/watch?v=s37GTK6JFcI 😢

Can you help find a suitable replacement?

https://github.com/dwyl/technology-stack

http://www.bloomberg.com/graphics/2015-paul-ford-what-is-code/ (long but good)

@iteles have you decided on CSS guidelines?
https://en.bem.info/method/

Should we have an FAQ section in the Readme or have a FAQ.md ?

I just recently came across dwyl and it seems like an amazing little hub of activity. 💜 The Touch Typing section caught my attention right away, simply because that's a skill I've been meaning to learn for some time now.

Here's the thing: all tutorials listed there seem pretty solid, but, I can only use Keybr, as it's the only one that allows switching between different keyboard layouts. It's not even a matter of QWERTY/DVORAK: German, French and Portuguese keyboards, among others, have subtle changes in their layouts that make using either other tutorial (Typing Club, BBC) impossible.

So, maybe there should be some way to let people know right away which layouts are supported in each tutorial. Maybe using flag emojis (🇬🇧, 🇺🇸, 🇵🇹, etc.), but I'm not sure how widely supported those are. Anyway, it's a small thing, but one I would've found useful. 😊

• Manifesto: https://ind.ie/about/manifesto/
• Funding: https://ind.ie/fund
• Goodbye ello: https://aralbalkan.com/notes/ello-goodbye/

Can we take this one step further...?

https://guides.github.com/activities/hello-world/

https://thimble.mozilla.org/

This is the old one:
https://github.com/TheOdinProject/curriculum

The node.js project has a good first contribution label to encourage people to get involved: https://github.com/nodejs/node/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+contribution%22

Can we do something similar?

If you have not already setup your computer to access github using ssh, the follow these instructions: https://help.github.com/articles/generating-ssh-keys/

Need to create a general code of conduct for dwyl, linked to dwyl/summer#8
(Create in separate repo for general use)

We need someone to grock Google Analytics well enough to teach it to other people. I know a fair amount, but we need someone who is passionate about stats/data/insights to take the lead. any volunteers?

• Getting started with CSS: https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_started
• The CSS Almanac: https://css-tricks.com/almanac/
• Shay's Learn to Code HTML & CSS: http://learn.shayhowe.com/html-css/
• Code Academy CSS: http://www.codecademy.com/en/tracks/htmlcss
• Flexbox: https://css-tricks.com/snippets/css/a-guide-to-flexbox

@iteles any others?

I've noticed that people getting to grips github are often flummoxed by vim.
Should we include a good vim tutorial in our Github section? Or create our own in docdis? http://www.openvim.com/

Two-Factor Auth makes your GitHub account Secure.

See:

• https://www.authy.com/
• https://help.github.com/articles/about-two-factor-authentication/

Hooray! 🎉

I quite like the sho shin symbol:

But I prefer:

What do _you_ think?

Good overview of Material Design ("different not better")
https://medium.com/android-news/material-design-is-different-not-better-87909af6ffe1

@iteles where are we keeping the links to design "patterns"?

again, as noted by @blossomica the Learn JavaScript video has been taken down... 😭

I'm beginning to think we need to re-prioritise #ProjectVideo ... https://github.com/dwyl/video/issues

“Your mind is like a parachute; it only works when it is open.” ~ Anthony D'Angelo
"I'm not young enough to know everything" ~ J. M. Barrie

These will most likely turn into a 'uniform' of sorts. And I would definitely wear some 'do what you love' t-shirts as part of my day-to-day wardrobe! [Trying hard not to spin this off into a clothing line - I see brush script in our future].

Tasks:

• Determine types of t-shirts
• Define budget
• Research and get quotes for screenprinted t-shirts
• Define print colours and sizes
• Define tee sizes and numbers required
• Order

What subjects are essential for everyone on our team to grok?
Need to create a prioritised list.

(Reminded today by issues #81 on micro-optimisations)

e.g. the iPhone 4 is not going to be updated by Apple so is now a Security vulnerability ...
http://www.intego.com/mac-security-blog/if-you-care-about-security-throw-away-your-iphone-4-right-now/

@iteles again, as noted by @blossomica the Learn CSS Video
link we had shared is broken! (because "MammothInteractive" wants people to pay for their content ...)

Please help source an alternative. thanks!

I've assumed yes, but this will lead to clumping of titles around these words. Don't know if that's important.

I'm going to be away in July and would like to learn/contribute/prep for portugal in the meantime. This might be documented elsewhere but I couldn't find it. Cheers 👍

@iteles can you please remind us which atom plugin you are using to track the section you are editing in Markdown doc? thanks!

• Eli Pariser TED Talk - online "filter bubbles" https://www.youtube.com/watch?v=B8ofWFx525s
• JS the better parts (ES6) - https://www.youtube.com/watch?v=PSGEjv3Tqo0

Would be nice to have an ordered list of our priorities so the things we consider most important are seen first.

These need to happen. Because they're awesome. And because our friends love stickers and will absolutely support us if we add a little awesomeness to their laptops.

Tasks:

• Determine design for stickers
• Define budget
• Research and get quotes
• Order

We need to develop a list of non-code tasks which can be done by anyone...
relates to: #63