brug-be / railsgirls_guide

New Rails Girls guide
http://brug-be.github.io/railsgirls_guide/
3 stars 5 forks source link

Open project directory instead of individual files #9

Open Bertg opened 9 years ago

Bertg commented 9 years ago

Opening multiple Sublime windows seemed confusing. Making the step to opening the entire rails folder surprising.

Maybe we should start from there. Maybe have a ready made folder to download, with the instructions / guide in there already?

wrtsprt commented 9 years ago

great idea to open the rails girls folder right in the beginning. i think in there they can still create the file themselves and have rails then create the app, but having the whole folder open in sublime gives perspective!

alicetragedy commented 9 years ago

I agree 100% – I showed my group right away how to open the whole folder instead of the file, so they can have the folder view on the left-hand side, which is one of the nicer features of Atom or Sublime as opposed to more "basic" editors. :+1: I also like the idea of the ready made folder.

Bertg commented 9 years ago

Should we - next to showing the side bar - also show of the "colouring"? This can help them understand if the colour is wrong, there might be something wrong with the code itself? Or do we keep that for a later step?

On 11 May 2015, at 08:41, Laura notifications@github.com wrote:

I agree 100% – I showed my group right away how to open the whole folder instead of the file, so they can have the folder view on the left-hand side, which is one of the nicer features of Atom or Sublime as opposed to more "basic" editors.
I also like the idea of the ready made folder.

— Reply to this email directly or view it on GitHub https://github.com/railsgirls-be/railsgirls_guide/issues/9#issuecomment-100787800.

alicetragedy commented 9 years ago

@Bertg I think ideally we can explain the coloring (you mean, for syntax highlighting?) right at the beginning by doing a short intro to the three tools (browser, editor, command line). They might not understand its use right away, but maybe they will notice it again once the color has the "wrong" color.

Note while we're talking about the editors: one of my students had installed atom instead of sublime, and atom apparently does not come with the tree view and the autocomplete by default, they are packages that need to be installed extra. Might be good to know (I don't use atom).

mariusandra commented 9 years ago

Like I said in #8, I don't think we're here to teach bash, so I would propose to remove this block:

$ mkdir railsgirls        # mkdir is equivalent to "make directory railsgirls"
$ cd railsgirls           # we 'enter' the new directory using command 'cd'
$ touch introduction.html # command 'touch' creates a new file called as indicated

... and instead tell them to make a new railsgirls folder somewhere on their desktop. Then they should open that folder in Sublime/Atom and use that to create the "introduction.html" file. This way we don't immediately plunge them into the terminal, but let them just use a text editor to create a HTML file.

Later I would open the terminal, cd into the directory and type rails new railsgirls-app right there, so the new folder shows up immediately in sublime/atom without any extra voodoo.

I then had my team move the "introductions.html" file straight into the railsgirls-app/public folder just using finder/explorer.

Bertg commented 9 years ago

:+1: on the "Don't move with bash" idea.

wrtsprt commented 8 years ago

So this issue is about updating the guide to suggest opening the project folder itself in the editor, not single files.

I made a new issue for the 'don't move stuff in bash subject' (https://github.com/railsgirls-be/railsgirls_guide/issues/20)