AlexsLemonade / AlexsLemonade/training-modules

Decide on consistent terms in intro to R: environment/workspace

Open
#413 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
77
Forks
35
Avg merge
18h 38m
Merged PRs (30d)
3

Description

> I'm using the word "environment" here but I realized that this notebook uses the word "environment" a couple of different ways, to refer both to the overall interface, and to the variables that are present in the "workspace", shown in the Environment pane.

> We should try to standardize on a single meaning for each word, if we can. Unfortunately, RStudio uses "workspace" (load/save/clear workspace) and "environment" (the name of the pane) in its interface to mean mostly the same thing, but it does mean that both of those words are problematic to describe the whole shebang, as we do on line 47 (and in the objectives).
Maybe we should call it the "RStudio Interface" which I don't love, but don't have anything better right now.

_Originally posted by @jashapiro in https://github.com/AlexsLemonade/training-modules/pull/403#discussion_r585895523_

Contributor guide

Open the contributing guide

Research direction

Locate the intro to R notebook and review line 47, the objectives, and the surrounding uses of “environment” and “workspace.” First determine consistent meanings for the terms, then update the affected wording throughout the notebook so the interface and its variables are described consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
r
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.