Skip to content

Clarify "bundle exec rails server" should be run inside "my_awesome_app" #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hqcasanova opened this issue Jul 2, 2014 · 4 comments

Comments

@hqcasanova
Copy link

This is a tiny omission that caused momentary panic at least in my case. If the text is followed to the letter, it appears that the command can be run outside the new project's folder. However, doing so makes the gem system grunt at you with a wonderfully descriptive "Could not locate Gemfile". Of course, little did I know that the solution was very simple: cd into the new project's folder, in this case "my_awesome_app".

@mayanring
Copy link
Owner

Hey, thanks for the feedback! I actually mention "To make a new Rails project, cd into your projects folder..." right above running rails new.

@hqcasanova
Copy link
Author

Hey! Thanks a lot for acknowledging receipt. I did read the phrase you mentioned. Problem is it's not correctly framed, I think. In its present form, it seems to mean what I described earlier. Let me explain why exactly.

The problem could be the absence of a saxon genitive. Perhaps saying "into your project's folder" would make things clearer. The word "projects" (without the genitive) led me to believe that the bundle exec command can be run outside the new project's folder (my_awesome_app). That is, inside a general "projects" folder that I had to create.

Also, as far as I understand, it's not until the rails new my_awesome_app is run that a project folder (named in this case "my_awesome_app") will exist. Therefore, I can't cd into it before I've run the command, as the phrase seems to suggest. Bear in mind that the reader might not foresee the byproduct of such command: a new directory called "my_awesome_app". I certainly didn't. Do you know what I mean?

Overall, I think minimal editing and a simple reordering of the instructions would do. That section of the text would then look something like this:

To make a new Rails project, run the following command:
rails new my_awesome_app

cd into your new project's folder my_awesome_app and run:
bundle exec rails server

Hope this helps.

@mayanring
Copy link
Owner

I actually meant "projects" folder as in "the folder which contains all your projects", not the folder for my_awesome_app. Running rails new from there would create the my_awesome_app directory.

I totally agree that it's not obvious that you need to run the bundle exec step from inside the my_awesome_app folder though. I'll make that change when I get a moment. Thanks!

@hqcasanova
Copy link
Author

Ahh, I see. Thanks for the swift reply.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants