Skip to content

doc: correct the FAQ contact answer and the Preface language list - #68

Merged
psadil merged 2 commits into
mainfrom
doc/front-matter
Sep 22, 2026
Merged

psadil merged 2 commits into
mainfrom
doc/front-matter

Conversation

@psadil

@psadil psadil commented Sep 22, 2026

Copy link
Copy Markdown
Collaborator

Two sentences in the front matter promised things the chapters do not deliver.

FAQ, "Who should I contact?" said that each kit lists its maintainer's contact information at the end, and to use those channels. No kit does: across every *.qmd there are no email addresses and no contact or maintainer statements outside the FAQ itself, and every chapter ends with its Citations section. Only six files carry a name-only authors: block (the Psychosocial kit, its imputation appendix, and the four CRF appendices); the MRI and omics kits have none. The answer now points at the two channels that exist: an issue on this repository for questions about a kit, and the data-access page on a2cps.org (already linked from the first FAQ entry) for questions about the data or about access to it.

Preface said the examples rely on "shell commands, R, and python". The book has 587 {r} chunks and 60 plain bash fences, and no python; the only other mention is the description of the PyBIDS package in the raw MRI kit, which is about an external tool and is unchanged. The sentence now says shell commands and R.

Neither file contains executable code, so there is no _freeze change; the preview render is the check that this holds. The prek hooks pass on both files.

Not included, for separate consideration:

  • An authors: block per kit, in the shape used by the six files that already have one (it renders as an "Authors" byline under the chapter title). This needs the per-kit maintainer mapping, and each touched chapter with code would need a re-render and a _freeze commit.
  • repo-actions: [issue] in _quarto.yml, which would add a "Report an issue" link to every page and make the FAQ answer discoverable from each kit.

🤖 Generated with Claude Code

psadil and others added 2 commits September 22, 2026 13:04
…s page

The FAQ said each kit lists its maintainer's contact information at the
end. No kit does: no chapter carries an email address or a contact or
maintainer statement, and every chapter ends with its Citations section.
Point readers at the channels that exist: an issue on this repository for
questions about a kit, and the data-access page for questions about the
data or about access to it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The book has no python examples: 587 `{r}` chunks and 60 plain bash
fences. The only other mention is the description of PyBIDS in the raw
MRI kit, which is about an external tool and stays.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

The preview for this pull request has been removed.

github-actions Bot added a commit that referenced this pull request Sep 22, 2026
@psadil
psadil merged commit 3e43c81 into main Sep 22, 2026
3 checks passed
github-actions Bot added a commit that referenced this pull request Sep 22, 2026
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