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

Lesson Contribution - Suggested Glossary changes #990

Open
Talishask opened this issue May 26, 2022 · 0 comments
Open

Lesson Contribution - Suggested Glossary changes #990

Talishask opened this issue May 26, 2022 · 0 comments

Comments

@Talishask
Copy link

I'm a member of The Carpentries Core Team and I'm submitting this issue on behalf of another member of the community. In most cases, I won't be able to follow up or provide more details other than what I'm providing below.


Suggested Glossary changes

(1) assertions.

If assertions remain in the lesson ( I agree with Issue #979 and others in the gitHub that exceptions are a more appropriate tool for defensive programming - assertions are best used for debugging ), including a glossary term for assertion error would assist. Proposed wording below:

assertion error

An error which is generated if the condition associated with an assertion expression is evaluated to be False

Reference to the error would appear in the Defensive Programming episode, for example

If it is true, Python does nothing, but if it is false, Python halts the problem immediately using an assertion error (../reference ...) and prints out the error message if one is provided

(2) very minor typo
There is a " at the end of the mutable explanation

Given that odd " and ' are an issue in coding, I think it best to avoid them in text.

mutable

Changeable. The value of mutable data can be altered after it has been created. See immutable."

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

1 participant