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

Further Reading Document #407

Open
trevordblack opened this issue Mar 22, 2020 · 3 comments
Open

Further Reading Document #407

trevordblack opened this issue Mar 22, 2020 · 3 comments
Milestone

Comments

@trevordblack
Copy link
Collaborator

Okay, I have a bit of a jumbled mess where you'd typically find a brain.

For the FurtherReading.html (or Bibliography.html, I prefer FurtherReading.html in the first draft), how do we want to structure it?

From the wiki: https://github.com/RayTracing/raytracing.github.io/wiki/Aggregation-of-Possible-Next-Steps

We have a couple of dissimilar things jumbled together.

  1. LOCATIONS of content
    • Chapters in the books
    • Blogs from the in1weekend blog spots
  2. TYPES of content
    • External resources
    • Possible next steps (exercises)
      • Some are found in the next book
      • Some are not found in the next book

This is biting off more than we can chew, but, for my own sanity, at least,
I would like the project to get to a place that,

  1. Overhaul of all the "Next Steps" chapters in the book.
    • One chapter at the end of each book
    • This chapter has
      • brief overview of topics covered in the next book
      • Possible exercises that are not covered in the next book
      • (don't mention topics from 2+ books on)
  2. The FurtherReading.html doc contains
    • No exercises
    • External resources for every chapter in the books
    • An Assumed Knowledge section covering the basics (math, programming)
    • A Common section for resources that are relevant to multiple books, chapters
    • An Extension section for resources that are the next places to learn
    • (Maybe) An Unsolved Research Problems section for state-of-the-art resources/questions

This is explicitly not a text book, but at some point we might need to have a conversation about Exercises. The books already nod toward having them (in the Further Reading sections), but the explicit outlining of Exercises introduces a lot of friction for the reader.

Indeed, all of the structure outlined above is an increase in friction for the reader. So I don't strongly recommend any of it, but it's a topic I've been ruminating on for a few weeks, and have largely not had any success in congealing. The excessive structure is simply a coping mechanism.

Originally posted by @trevordblack in #299 (comment)

@hollasch
Copy link
Collaborator

Old branch rebased to dev-major: further-reading-2.

In my opinion, I'd rather see the bibliography grow more organically — the current outline is quite aggressive in scope and easy to put off as a hard, large task.

@trevordblack
Copy link
Collaborator Author

Propose punting to backlog

@hollasch hollasch modified the milestones: v4.0.0-book1-rel, Backlog Jun 19, 2023
@hollasch
Copy link
Collaborator

Agreed.

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

2 participants