Skip to content
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

Some ambiguity in this phrase: you can open up a console session... #1

Closed
brigj1 opened this issue Jun 15, 2022 · 0 comments · Fixed by #5
Closed

Some ambiguity in this phrase: you can open up a console session... #1

brigj1 opened this issue Jun 15, 2022 · 0 comments · Fixed by #5
Labels
se curriculum Issue for lessons in the Software Engineering program

Comments

@brigj1
Copy link

brigj1 commented Jun 15, 2022

Canvas Link

https://learning.flatironschool.com/courses/5187/assignments/180532?module_item_id=398258

Concern

As a student, I'm conflicted in reading this statement:
For instance, to create a new record in the games table, you can open up a console session ...

"can" is not a directive to do so, but previous labs seem to have been written where "can" is used as a directive, so I'm not sure. Or, maybe a "seeds" way will come along and I will have made a mess if I do this step. So I scroll down and look for something like this, and I find it. But why did I have to sleuth through the text?

I like that the example is here, but less ambiguity would have let me focus on learning content rather than tiptoe through the material to make sure I don't break something.

Additional Context

No response

Suggested Changes

instead of this:
For instance, to create a new record in the games table, you can open up a console session with bundle exec rake console and use the .create method:

maybe this?:
For instance, to create a new record in the games table, you could open up a console session with bundle exec rake console and use the .create method (but don't do this right now):

Maybe there's a better way to say this, but now ambiguity is gone.
I guess "tense" of the following sentences would have to adjust, e.g. there's this:
Awesome! Our database now has some data in it. We can create a few more games:

but oh well.
These succeeding phrases currently show further invitation/directive to do these commands now. If there won't be a problem, then add a clear invitation to do so rather than "you can". Removing ambiguity about what is ok to do would help. I don't want to make a mess and I don't know enough yet - am depending on guidance of the text.

@brigj1 brigj1 added the se curriculum Issue for lessons in the Software Engineering program label Jun 15, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
se curriculum Issue for lessons in the Software Engineering program
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant