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

Reconsider the position of 7.1 Scripts #1407

Open
mitsuoxv opened this issue Apr 1, 2023 · 3 comments
Open

Reconsider the position of 7.1 Scripts #1407

mitsuoxv opened this issue Apr 1, 2023 · 3 comments

Comments

@mitsuoxv
Copy link
Contributor

mitsuoxv commented Apr 1, 2023

I cried no way, when I read the first sentence "So far, you have used the console to run code" in 7.1 Scripts. It does not make sense that this comes after 5 Workflow: code style, and code before this should not exceed around 5 lines.
I would like to suggest that 7.1 Scripts shall move into 3 Workflow: basics or 5 Workflow: code style.

@mine-cetinkaya-rundel
Copy link
Collaborator

I believe it's too late for us to consider this change for 2e but something we might consider for a subsequent edition, thank you!

@jcornickm
Copy link

While my reaction was more muted, I agree with Mitsuoxv. When I read that sentence my reaction was, simply: "no, I have been using scripts to run code".

@krlmlr
Copy link
Contributor

krlmlr commented May 22, 2023

Section 5.5 (Sectioning comments) mentions scripts which are only to be introduced in Section 7. Perhaps 5.5 could find a place between 7.1.1 and 7.1.2?

In an ideal world, 7.1 would come after 3.4 or before 5.1 (and the chapter would be called "basics and scripts" or "scripts and code style"), and chapter 7 would be called "Projects".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants