Skip to content

added a refrence of section 4.3 to 3.4 instead of moving a large section of 4.3 - #369

Open
DieuMerci225 wants to merge 2 commits into
RunestoneInteractive:masterfrom
DieuMerci225:chapter3.4
Open

added a refrence of section 4.3 to 3.4 instead of moving a large section of 4.3#369
DieuMerci225 wants to merge 2 commits into
RunestoneInteractive:masterfrom
DieuMerci225:chapter3.4

Conversation

@DieuMerci225

Copy link
Copy Markdown

Description

I went with the reference approach since it keeps the chapter structure intact and avoids moving a large section. I added a cross-reference in 3.4, right where try/catch is first introduced, pointing readers to the exception handling section (4.3) for a fuller explanation.

fixes #258

image

tested with local build

Reviewed by @habibasorour

@pearcej pearcej left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't agree. The flow of the text needs to be logical, and it needs to build. One should NOT have to jump forward and eseentially read a whole chapter on file handling.

@DieuMerci225

Copy link
Copy Markdown
Author

@pearcej That makes sense working on another solution to solve the issue

@pearcej

pearcej commented Aug 6, 2026

Copy link
Copy Markdown
Collaborator

@DieuMerci225 I expect the original contribution was from an AI tool. Think about what is learning appropriate at this point.

@DieuMerci225

Copy link
Copy Markdown
Author

@pearcej The issue suggested that since 3.4 introduces try/catch, the exception handling section could either become a subsection of 3.4 or be linked from it. After re-reading both sections, I think the best move is to keep 3.4's explanation minimal rather than expanding it. It already explains try/catch well enough for what this chapter needs, which is just handling the one exception in the file-opening example. Making it a subsection or forcing a jump to a later chapter would pull in more than the reader needs at this point. The deeper explanation belongs in 4.3 on exception handling, and 3.4 already notes that more detail comes later in the book, which is exactly what happens in 4.3.

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

Successfully merging this pull request may close these issues.

have 4.5 earlier in the book

2 participants