Skip to content

Add chapters and reorganize some of the content #29

Draft
svteichman wants to merge 11 commits into
mainfrom
add_chapters_reorganize
Draft

Add chapters and reorganize some of the content #29
svteichman wants to merge 11 commits into
mainfrom
add_chapters_reorganize

Conversation

@svteichman

@svteichman svteichman commented Jun 22, 2026

Copy link
Copy Markdown
Collaborator

Purpose/implementation Section

This (draft) PR reorganizes some of the material, adding it into two new chapters for collecting and acquiring clinical data. The goal of this is to pull some of the material out of the data uses chapter, so that that chapter can really focus on how to use data (and not also include how to collect data).

What changes are being implemented in this Pull Request?

Two new chapters are added, "how to collect data" and "how to acquire data". They are added in that order after specific data types and before data uses.

Several sections that were previously in data uses are moved into the data collection chapter, including the sections on case report forms, clinical studies and trials, and research design considerations. Another section on observational studies (including different types of studies) is proposed.

The chapter about how to acquire data is mostly empty, with some proposed sections.

In the data uses chapter, the section on clinical data for cancer prevention and care is slightly reorganized to add subsections, and then content has been removed (and put into the data collection section). One question that I have here is in the section about questions that can be asked from retrospective analyses, if these questions actually apply to observational studies (both prospective and retrospective).

What was your approach?

I reorganized some of this material based on what I thought made for a more straightforward flow. This is a draft PR because this is my initial attempt but I want to get feedback before I move forward with this!

Tell potential reviewers what kind of feedback you are soliciting.

I am curious how this organization looks! Specifically,

  • does adding chapters for collecting and acquiring data make sense?
  • does the order in which I've added these chapters (with respect to the existing chapters) make sense?
  • does separating out data collection from data uses make sense?
  • it seems like we don't have content in the Google Drive (as far as I can tell) for acquiring data. Do these sections make sense and how should we go about drafting them?
  • observation studies vs retrospective studies - how do we want to separate these out?
  • do we want to add the additional sections that I've suggested/started to draft on specific types of observational studies (i.e. cohort studies, case-control studies, cross-sectional studies)?

New Content Checklist

@svteichman svteichman marked this pull request as ready for review June 22, 2026 18:13
@github-actions

github-actions Bot commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

No spelling errors! 🎉
Comment updated at 2026-07-07-17:45:41 with changes from 70e3b3f

@github-actions

github-actions Bot commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

No broken url errors! 🎉
Comment updated at 2026-07-07-17:45:41 with changes from 70e3b3f

@github-actions

github-actions Bot commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Re-rendered previews from the latest commit:

* note not all html features will be properly displayed in the "quick preview" but it will give you a rough idea.

Updated at 2026-07-07 with changes from the latest commit 70e3b3f

@svteichman svteichman marked this pull request as draft June 22, 2026 18:30
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.

1 participant