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

Update 01-intro.md #852

Open
wants to merge 1 commit into
base: gh-pages
Choose a base branch
from

Conversation

RachelMc-dev
Copy link

@RachelMc-dev RachelMc-dev commented Jul 15, 2020

Add clearer definition of what a variable is, this could be done somewhere around line 19. For example: Variables are used to store information to be referenced and manipulated in a computer program. It is helpful to think of variables as containers that hold information. Their sole purpose is to label and store data in memory. This data can then be used throughout your program.

Instructions

Thanks for contributing! ❤️

If this contribution is for instructor training, please email the link to this contribution to
checkout@carpentries.org so we can record your progress. You've completed your contribution
step for instructor checkout by submitting this contribution!

Keep in mind that lesson maintainers are volunteers and it may take them some time to
respond to your contribution. Although not all contributions can be incorporated into the lesson
materials, we appreciate your time and effort to improve the curriculum. If you have any questions
about the lesson maintenance process or would like to volunteer your time as a contribution
reviewer, please contact The Carpentries Team at team@carpentries.org.

You may delete these instructions from your comment.

- The Carpentries

Add clearer definition of what a variable is, this could be done somewhere around line 19. For example: Variables are used to store information to be referenced and manipulated in a computer program. It is helpful to think of variables as containers that hold information. Their sole purpose is to label and store data in memory. This data can then be used throughout your program.
Copy link
Contributor

@ldko ldko left a comment

Hi @RachelMc-dev , thanks for submitting this contribution! I think it makes sense to give a bit more on what variables are as you are doing here. I suggest moving such explanation to after when the term "variable" is introduced in the text, so following the line: "To do anything useful with data, we need to assign its value to a variable." Let's see if @maxim-belkin has any thoughts about the new text proposed here.

@maxim-belkin
Copy link
Contributor

maxim-belkin commented Jul 21, 2020

Hi @RachelMc-dev. Thank you for your contribution!

  1. What was your motivation for suggesting this clarification?
  2. SWC workshops are hands-on workshops in which coding sessions are interspersed with explanations. These explanations are closely connected to the code participants see. Your explanation is somewhat abstract and has a signitifant cognitive load (you mention "variables", "information", "data", "computer program", "labels", "containers", "memory" not to mentions connections between these). It has to be simplified.
  3. Related to the points above and Lauren's comment: we can't start with this explanation. A better place for it would be after the In layman's terms, **a variable is a name for a value**. sentence.

@RachelMc-dev
Copy link
Author

RachelMc-dev commented Jul 21, 2020

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

Successfully merging this pull request may close these issues.

None yet

3 participants