2024 updates #265
Merged
2024 updates #265
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…ns of what should be done in every project
samumantha
approved these changes
Aug 30, 2024
content/dependencies.md
Outdated
| @@ -25,7 +25,7 @@ From [xkcd - dependency](https://xkcd.com/2347/). Another image that might be fa | |||
| ````{discussion} Kitchen analogy | |||
| - Software <-> recipe | |||
| - Data <-> ingredients | |||
| - Libraries <-> cooking books/blogs | |||
| - Libraries <-> Pots/Tools | |||
There was a problem hiding this comment.
Sounds sensible to me.
One thing about consistency: uppercase or lowercase? Maybe all uppercase makes sense here, then above analogies should also be adapted.
bast
reviewed
Aug 30, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Teemu and myself discussed the analogy a bit and while we understand the libraries <-> collection of recipies idea, we think it's more like the libraries are tools (yes, they are just code, but they are used as tools) and without tools you cannot do your recipe, which actually mentions these tools. Also, the container page mentions them as tools so having it consistent feels clearer to us.
We also changed the "Where to go" page such that we finish the lecture with a "Important for every project" section, where we highlight the (in our opinion) minimum work necessary in any project (clear structure of the project folder, recorded steps for reproduction, list of dependencies).
@eglerean and @samumantha, since you gave this lecture in the past I thought it would be good to get your comments as well.