Chapter 9: Best Practices and Important Data Considerations

[x] stub in Quarto
[x] convert Google Docs to markdown (see #33 for some notes)
[x] download figures (& rename if necessary)
[x] manually incorporate figures (paths, text, & references)
[x] split sentences on separate lines
- pattern: (?<=[^1])\.[ ]{1,2}(?=\w)
- sub:
```
.
```
```
(or with two spaces for indented bullets)
```
[x] replace curly quotes with straight quotes [“”] and [‘’]
[x] standardize hyphens. Replace — with --. This an em dash replaced by two hyphens (which Pandoc will convert to a dash when rendering the html).
[x] add spaces are em-dashes. This follows AP style guide, that's designed for skinny newspapers.
- add space before with pattern (?<=[^ !-])-{2}(?![+-]) and sub --
- add space before with pattern (?<![+-])-{2}(?=[^ >-]) and sub --
[x] add {{< fa lock title="Link requires an N3C Data Enclave account" >}} (with a space separating the closing ) and the leading {{) (see #49 for some notes)
[x] replace +/- with ± and other scientific symbols
[x] "e.g." and "i.e." should be followed by a comma, and not italicized (NIH)
[x] outgoing cross refs (make sure the references to other chapters/sections/figures/tables are resolved)
[x] incoming cross refs (define anchors for all headers for other chapters/sections to refer to)
[x] end each figure caption with a period (#116)
[x] walk-through with author
[x] a lot of author info is missing --please see what specs they want listed for themselves
[x] address

{Add a short paragraph here about what a protocol is, and if it’s different than the steps outlined above (I assume not, just specialized for RWD analyses)}
[x] The "Protocol Outline" is not consistent with the entries in the text. Is it even necessary? The Chapter's TOC in the right margin will reflect this dynamically
[x] Needs reference at "[cite]"
- [x]
- [x]
[x] Incomplete sentence:
[ ] The GAP text needs a url. And the sentence need to be completed.
[x] remove "undergoing final edits..." callout
https://github.com/National-COVID-Cohort-Collaborative/guide-to-n3c-v1/blob/main/chapters/onboarding.md
https://docs.google.com/document/d/158DkTeYQjEYG9c0zftyIglducWdoKIWT9z1SOLLwpGo/edit

National-COVID-Cohort-Collaborative / guide-to-n3c-v1

Chapter 9: Best Practices and Important Data Considerations #138