r4ds icon indicating copy to clipboard operation
r4ds copied to clipboard

Reconsider the position of 7.1 Scripts

Open mitsuoxv opened this issue 2 years ago • 3 comments

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.

mitsuoxv avatar Apr 01 '23 01:04 mitsuoxv

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!

mine-cetinkaya-rundel avatar Apr 10 '23 02:04 mine-cetinkaya-rundel

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".

jcornickm avatar May 03 '23 14:05 jcornickm

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".

krlmlr avatar May 22 '23 05:05 krlmlr