data-analyst-mcp 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/README.md +286 -262
  2. package/dist/adapters/bjs.d.ts +13 -0
  3. package/dist/adapters/bjs.js +28 -0
  4. package/dist/adapters/bjs.js.map +1 -0
  5. package/dist/adapters/cbp.d.ts +5 -0
  6. package/dist/adapters/cbp.js +64 -0
  7. package/dist/adapters/cbp.js.map +1 -0
  8. package/dist/adapters/cdc-wonder.d.ts +5 -0
  9. package/dist/adapters/cdc-wonder.js +68 -0
  10. package/dist/adapters/cdc-wonder.js.map +1 -0
  11. package/dist/adapters/cpsc.d.ts +4 -0
  12. package/dist/adapters/cpsc.js +125 -0
  13. package/dist/adapters/cpsc.js.map +1 -0
  14. package/dist/adapters/fhwa.d.ts +9 -0
  15. package/dist/adapters/fhwa.js +16 -0
  16. package/dist/adapters/fhwa.js.map +1 -0
  17. package/dist/adapters/foreign-assistance.d.ts +9 -0
  18. package/dist/adapters/foreign-assistance.js +42 -0
  19. package/dist/adapters/foreign-assistance.js.map +1 -0
  20. package/dist/adapters/hud-ahar.d.ts +3 -0
  21. package/dist/adapters/hud-ahar.js +80 -0
  22. package/dist/adapters/hud-ahar.js.map +1 -0
  23. package/dist/adapters/nces.d.ts +10 -0
  24. package/dist/adapters/nces.js +32 -0
  25. package/dist/adapters/nces.js.map +1 -0
  26. package/dist/adapters/nsf.d.ts +11 -0
  27. package/dist/adapters/nsf.js +25 -0
  28. package/dist/adapters/nsf.js.map +1 -0
  29. package/dist/adapters/onrr.d.ts +9 -0
  30. package/dist/adapters/onrr.js +35 -0
  31. package/dist/adapters/onrr.js.map +1 -0
  32. package/dist/adapters/sba.d.ts +10 -0
  33. package/dist/adapters/sba.js +134 -0
  34. package/dist/adapters/sba.js.map +1 -0
  35. package/dist/adapters/treasury-tic.d.ts +30 -0
  36. package/dist/adapters/treasury-tic.js +149 -0
  37. package/dist/adapters/treasury-tic.js.map +1 -0
  38. package/dist/adapters/uscourts.d.ts +8 -0
  39. package/dist/adapters/uscourts.js +8 -0
  40. package/dist/adapters/uscourts.js.map +1 -0
  41. package/dist/analysis/cite.d.ts +9 -1
  42. package/dist/analysis/cite.js +9 -2
  43. package/dist/analysis/cite.js.map +1 -1
  44. package/dist/bin/cli.d.ts +2 -0
  45. package/dist/bin/cli.js +17 -0
  46. package/dist/bin/cli.js.map +1 -1
  47. package/dist/core/generic-rest.js +42 -17
  48. package/dist/core/generic-rest.js.map +1 -1
  49. package/dist/core/guard.d.ts +32 -0
  50. package/dist/core/guard.js +176 -0
  51. package/dist/core/guard.js.map +1 -0
  52. package/dist/core/http.d.ts +10 -0
  53. package/dist/core/http.js +36 -7
  54. package/dist/core/http.js.map +1 -1
  55. package/dist/core/keys.d.ts +13 -3
  56. package/dist/core/keys.js +67 -7
  57. package/dist/core/keys.js.map +1 -1
  58. package/dist/core/package.d.ts +12 -3
  59. package/dist/core/package.js +56 -12
  60. package/dist/core/package.js.map +1 -1
  61. package/dist/core/secret_patterns.d.ts +6 -0
  62. package/dist/core/secret_patterns.js +20 -0
  63. package/dist/core/secret_patterns.js.map +1 -0
  64. package/dist/core/tabular.d.ts +43 -1
  65. package/dist/core/tabular.js +149 -6
  66. package/dist/core/tabular.js.map +1 -1
  67. package/dist/envelope.js +3 -1
  68. package/dist/envelope.js.map +1 -1
  69. package/dist/index.d.ts +29 -22
  70. package/dist/index.js +45 -46
  71. package/dist/index.js.map +1 -1
  72. package/dist/remote/app.js +87 -31
  73. package/dist/remote/app.js.map +1 -1
  74. package/dist/remote/oauth.js +8 -1
  75. package/dist/remote/oauth.js.map +1 -1
  76. package/dist/remote/pages.d.ts +3 -7
  77. package/dist/remote/pages.js +49 -19
  78. package/dist/remote/pages.js.map +1 -1
  79. package/dist/remote/sign.d.ts +7 -1
  80. package/dist/remote/sign.js +33 -7
  81. package/dist/remote/sign.js.map +1 -1
  82. package/dist/remote/store.js +14 -5
  83. package/dist/remote/store.js.map +1 -1
  84. package/dist/report/audit_report.js +29 -7
  85. package/dist/report/audit_report.js.map +1 -1
  86. package/dist/report/build_report.js +34 -4
  87. package/dist/report/build_report.js.map +1 -1
  88. package/dist/report/method_audit.js +10 -1
  89. package/dist/report/method_audit.js.map +1 -1
  90. package/dist/report/scan_secrets.d.ts +4 -1
  91. package/dist/report/scan_secrets.js +38 -18
  92. package/dist/report/scan_secrets.js.map +1 -1
  93. package/dist/server.d.ts +3 -1
  94. package/dist/server.js +46 -13
  95. package/dist/server.js.map +1 -1
  96. package/dist/tools.js +27 -6
  97. package/dist/tools.js.map +1 -1
  98. package/guide/WORKFLOW.md +134 -134
  99. package/guide/assets/disclaimer.txt +1 -1
  100. package/guide/assets/download_data.ps1 +164 -162
  101. package/guide/assets/download_data.sh +8 -2
  102. package/guide/assets/report_template.html +597 -597
  103. package/guide/references/routing.md +198 -171
  104. package/guide/references/style_guide.md +398 -398
  105. package/package.json +56 -56
  106. package/packs/acf/endpoints.json +114 -114
  107. package/packs/acf/policy.json +104 -104
  108. package/packs/actuaries/endpoints.json +82 -82
  109. package/packs/actuaries/policy.json +109 -109
  110. package/packs/bea/assets/download_bea.ps1 +182 -182
  111. package/packs/bea/docs/bea_api.md +461 -461
  112. package/packs/bea/docs/datasets.md +157 -157
  113. package/packs/bea/docs/report_patterns.md +112 -112
  114. package/packs/bea/policy.json +170 -170
  115. package/packs/bea/source.md +152 -152
  116. package/packs/bjs/endpoints.json +150 -0
  117. package/packs/bjs/policy.json +114 -0
  118. package/packs/bjs/source.md +98 -0
  119. package/packs/bls/assets/download_bls.ps1 +152 -152
  120. package/packs/bls/docs/analysis_patterns.md +108 -108
  121. package/packs/bls/docs/bls_api.md +73 -73
  122. package/packs/bls/docs/series_ids.md +149 -149
  123. package/packs/bls/policy.json +238 -238
  124. package/packs/bts/endpoints.json +346 -346
  125. package/packs/bts/policy.json +94 -94
  126. package/packs/cbp/endpoints.json +31 -0
  127. package/packs/cbp/policy.json +85 -0
  128. package/packs/cbp/source.md +57 -0
  129. package/packs/cdc/endpoints.json +197 -197
  130. package/packs/cdc/policy.json +83 -83
  131. package/packs/cdc/source.md +1 -1
  132. package/packs/cdc-wonder/endpoints.json +26 -0
  133. package/packs/cdc-wonder/policy.json +84 -0
  134. package/packs/cdc-wonder/source.md +53 -0
  135. package/packs/census/endpoints.json +99 -99
  136. package/packs/cfpb/endpoints.json +326 -326
  137. package/packs/cfpb/policy.json +119 -119
  138. package/packs/clinical-trials/endpoints.json +166 -166
  139. package/packs/clinical-trials/policy.json +84 -84
  140. package/packs/cms/endpoints.json +69 -69
  141. package/packs/cms/policy.json +96 -96
  142. package/packs/college-scorecard/endpoints.json +252 -252
  143. package/packs/college-scorecard/policy.json +106 -106
  144. package/packs/college-scorecard/source.md +1 -1
  145. package/packs/congress/endpoints.json +1701 -1701
  146. package/packs/congress/policy.json +117 -117
  147. package/packs/cpsc/endpoints.json +91 -0
  148. package/packs/cpsc/policy.json +91 -0
  149. package/packs/cpsc/source.md +76 -0
  150. package/packs/dhs-ohss/endpoints.json +66 -66
  151. package/packs/dhs-ohss/policy.json +107 -107
  152. package/packs/dhs-ohss/source.md +1 -1
  153. package/packs/doj-news/endpoints.json +59 -59
  154. package/packs/doj-news/policy.json +96 -96
  155. package/packs/doj-news/source.md +1 -1
  156. package/packs/dol/endpoints.json +817 -817
  157. package/packs/dol/policy.json +135 -135
  158. package/packs/eia/endpoints.json +717 -717
  159. package/packs/eia/policy.json +112 -112
  160. package/packs/epa/endpoints.json +291 -291
  161. package/packs/epa/policy.json +99 -99
  162. package/packs/epa-aqs/endpoints.json +173 -173
  163. package/packs/epa-aqs/policy.json +96 -96
  164. package/packs/fbi/endpoints.json +1841 -1841
  165. package/packs/fbi/policy.json +118 -118
  166. package/packs/fbi/source.md +3 -3
  167. package/packs/fda/endpoints.json +237 -237
  168. package/packs/fda/policy.json +121 -121
  169. package/packs/fdic/endpoints.json +416 -416
  170. package/packs/fdic/policy.json +83 -83
  171. package/packs/fec/endpoints.json +707 -707
  172. package/packs/fec/policy.json +93 -93
  173. package/packs/fed-board/endpoints.json +89 -89
  174. package/packs/fed-board/policy.json +136 -136
  175. package/packs/federal-register/endpoints.json +143 -143
  176. package/packs/federal-register/policy.json +86 -86
  177. package/packs/fema/endpoints.json +645 -645
  178. package/packs/fema/policy.json +103 -103
  179. package/packs/fhfa/endpoints.json +105 -105
  180. package/packs/fhfa/policy.json +109 -109
  181. package/packs/fhwa/endpoints.json +48 -0
  182. package/packs/fhwa/policy.json +91 -0
  183. package/packs/fhwa/source.md +59 -0
  184. package/packs/foreign-assistance/endpoints.json +166 -0
  185. package/packs/foreign-assistance/policy.json +80 -0
  186. package/packs/foreign-assistance/source.md +76 -0
  187. package/packs/fred/assets/download_fred.ps1 +122 -122
  188. package/packs/fred/docs/analysis_patterns.md +124 -124
  189. package/packs/fred/docs/fred_api.md +94 -94
  190. package/packs/fred/docs/series.md +188 -188
  191. package/packs/fred/policy.json +253 -253
  192. package/packs/fsa/endpoints.json +150 -150
  193. package/packs/fsa/policy.json +99 -99
  194. package/packs/fsa/source.md +1 -1
  195. package/packs/govinfo/endpoints.json +519 -519
  196. package/packs/gsa-calc/endpoints.json +93 -93
  197. package/packs/gsa-calc/policy.json +97 -97
  198. package/packs/hud/endpoints.json +146 -146
  199. package/packs/hud/policy.json +84 -84
  200. package/packs/hud/source.md +1 -1
  201. package/packs/hud-ahar/endpoints.json +92 -0
  202. package/packs/hud-ahar/policy.json +88 -0
  203. package/packs/hud-ahar/source.md +72 -0
  204. package/packs/ipums/docs/report_patterns.md +117 -117
  205. package/packs/irs-soi/endpoints.json +114 -114
  206. package/packs/irs-soi/policy.json +107 -107
  207. package/packs/medicaid/endpoints.json +412 -412
  208. package/packs/medicaid/policy.json +108 -108
  209. package/packs/naep/endpoints.json +217 -217
  210. package/packs/naep/policy.json +100 -100
  211. package/packs/naep/source.md +1 -1
  212. package/packs/nces/endpoints.json +101 -0
  213. package/packs/nces/policy.json +99 -0
  214. package/packs/nces/source.md +75 -0
  215. package/packs/nhtsa/endpoints.json +132 -132
  216. package/packs/nhtsa/policy.json +93 -93
  217. package/packs/nhtsa/source.md +1 -1
  218. package/packs/nih/endpoints.json +452 -452
  219. package/packs/nih/policy.json +86 -86
  220. package/packs/noaa/endpoints.json +431 -431
  221. package/packs/noaa/policy.json +95 -95
  222. package/packs/nrel/endpoints.json +327 -327
  223. package/packs/nrel/policy.json +96 -96
  224. package/packs/nsf/endpoints.json +33 -0
  225. package/packs/nsf/policy.json +83 -0
  226. package/packs/nsf/source.md +59 -0
  227. package/packs/nws/endpoints.json +271 -271
  228. package/packs/nws/policy.json +82 -82
  229. package/packs/nyfed/endpoints.json +80 -80
  230. package/packs/nyfed/policy.json +92 -92
  231. package/packs/omb/endpoints.json +460 -460
  232. package/packs/omb/policy.json +106 -106
  233. package/packs/onrr/endpoints.json +198 -0
  234. package/packs/onrr/policy.json +91 -0
  235. package/packs/onrr/source.md +55 -0
  236. package/packs/open-payments/endpoints.json +297 -297
  237. package/packs/open-payments/policy.json +101 -101
  238. package/packs/opm/assets/download_opm.ps1 +125 -125
  239. package/packs/opm/docs/fields.md +184 -184
  240. package/packs/opm/docs/opm_api.md +71 -71
  241. package/packs/opm/docs/report_patterns.md +83 -83
  242. package/packs/opm/lib/data_dictionary.csv +73 -73
  243. package/packs/pbgc/endpoints.json +483 -483
  244. package/packs/pbgc/policy.json +94 -94
  245. package/packs/philfed/endpoints.json +85 -85
  246. package/packs/philfed/policy.json +94 -94
  247. package/packs/port.json +65 -0
  248. package/packs/regulations/endpoints.json +287 -287
  249. package/packs/regulations/policy.json +86 -86
  250. package/packs/sba/endpoints.json +34 -0
  251. package/packs/sba/policy.json +86 -0
  252. package/packs/sba/source.md +60 -0
  253. package/packs/sec/endpoints.json +236 -236
  254. package/packs/sec/policy.json +86 -86
  255. package/packs/senate-lobbying/endpoints.json +553 -553
  256. package/packs/senate-lobbying/policy.json +99 -99
  257. package/packs/snapqc/endpoints.json +1426 -1426
  258. package/packs/snapqc/policy.json +92 -92
  259. package/packs/treasury/catalog.json +2267 -2267
  260. package/packs/treasury/docs/api_guide.md +245 -245
  261. package/packs/treasury/docs/datasets.md +56 -56
  262. package/packs/treasury/docs/report_patterns.md +126 -126
  263. package/packs/treasury/policy.json +159 -159
  264. package/packs/treasury/source.md +170 -165
  265. package/packs/treasury-tic/endpoints.json +77 -0
  266. package/packs/treasury-tic/policy.json +89 -0
  267. package/packs/treasury-tic/source.md +80 -0
  268. package/packs/treasury-yields/endpoints.json +226 -226
  269. package/packs/treasury-yields/policy.json +86 -86
  270. package/packs/usaspending/endpoints.json +1315 -1315
  271. package/packs/usaspending/policy.json +109 -109
  272. package/packs/uscourts/endpoints.json +22 -0
  273. package/packs/uscourts/policy.json +87 -0
  274. package/packs/uscourts/source.md +56 -0
  275. package/packs/usda-fna/policy.json +133 -133
  276. package/packs/usda-fooddata/endpoints.json +180 -180
  277. package/packs/usda-fooddata/policy.json +94 -94
  278. package/packs/usda-nass/endpoints.json +323 -323
  279. package/packs/usda-nass/policy.json +95 -95
  280. package/packs/usda-outlook/endpoints.json +86 -86
  281. package/packs/usda-outlook/policy.json +109 -109
  282. package/packs/usgs/endpoints.json +313 -313
  283. package/packs/usgs/policy.json +95 -95
  284. package/packs/usitc/endpoints.json +74 -74
  285. package/packs/usitc/policy.json +111 -111
  286. package/packs/uspto/endpoints.json +141 -141
  287. package/packs/uspto/policy.json +95 -95
  288. package/packs/uspto/source.md +1 -1
  289. package/packs/va/endpoints.json +414 -414
  290. package/packs/va/policy.json +101 -101
  291. package/packs/world-bank/endpoints.json +122 -122
  292. package/packs/world-bank/policy.json +101 -101
@@ -1,398 +1,398 @@
1
- # Style guide for data reports
2
-
3
- The rules that matter for a short data product: summary, exhibit-driven sections, notes and sources, a
4
- data-and-methods appendix, and an optional About This Document. Convention below: **OK** = correct,
5
- **Not** = incorrect. Spelling follows the first entry in Merriam-Webster's online dictionary (www.m-w.com);
6
- otherwise defer to *The Chicago Manual of Style*. These rules distill the house style of U.S. statistical
7
- and policy publishers; they are organization-neutral. Where an organization is named in a report
8
- (`organization` in `report.json`), the examples below write `<Organization>`. One guide for every source;
9
- a pack's `source.md` adds only its own names, units and citation forms (for example the dataset to cite).
10
-
11
- ## 1. Tone and voice
12
-
13
- - **Write for an intelligent, well-informed reader** with no formal economics training. Do not
14
- talk down; avoid jargon; explain each concept as it comes up.
15
- - **Jargon only when essential for precision, defined at first use.** Short definitions go in parentheses right after
16
- the term (*the quintile (one-fifth) of households with the highest earnings*); longer ones in a separate sentence or a
17
- footnote. Or avoid the term altogether. Always define: *mean*, *median*, *quintile*, *standard deviation*,
18
- *transfers*, *nominal*, *real* (*real earnings (that is, earnings adjusted to remove the effects of inflation)*).
19
- - **Plain English; omit needless words.** OK: *because, now, to, about, use, before, after, later, if, can, help,
20
- spending, except for, daily, end*. Not: "due to the fact that", "at the present time", "in order to", "for the purpose
21
- of", "regarding/concerning", "utilize", "prior to", "subsequent to", "upon", "expenditures", "facilitate", "is able
22
- to", "in the event that", "with the exception of", "period of time", "a larger number of".
23
- - **Active voice.** Passive only to stress the action or when the actor is unknown or unimportant (projections
24
- often qualify: *Employment is projected to grow*). *will likely* is fine. **No contractions.** Cut *fairly, quite, rather, somewhat*,
25
- *very* (unless it makes a needed distinction), *lion's share*, *appear to/seem to*. Avoid emphatic *do/did*.
26
- - **Who speaks.** Never "we", "our" or "I" in a report or paper. When the product names an organization, use its
27
- name: *<Organization> estimates that …* (the full name at first reference in each stand-alone part, then the
28
- short name or abbreviation; never "the" before an abbreviation). When no organization is named, write in the
29
- third person: *this analysis*, *the estimates*, *the data show*, *the employment rate was …*. The verb
30
- *estimates* takes *that*; the noun takes the possessive (*the analysis's estimates of the share*).
31
- - **Say what was done, in plain verbs.** *estimates*, *projects*, *expects*, *finds*, *shows* — not "predicts".
32
- *assume* is for stated policy or scenario specifications, not for the analyst's own estimates (*the estimates
33
- are based on …*, *in this analysis's assessment …*). A model or scenario does not "assume"; it *reflects the
34
- assumption*. *forecast* only for economic projections (past tense *forecast*, Not "forecasted").
35
- - **Neutral tone.** Report what the data show and what a change would do. Do not add policy advice unless the user
36
- asked for recommendations, and then keep them in a clearly labeled section. Avoid *reform* (implies improvement);
37
- use *change*. Describe associations; do not imply causation the analysis cannot support.
38
- - **Conditional for anything hypothetical**: *the option would raise...*; *might* (Not *may*) for hypotheticals. *may have*
39
- = writer does not know; *might have* = could have happened, but did not. Keep tenses in sequence: *if borrowers
40
- defaulted, the lenders would cover...* / *if borrowers default, the lenders will cover...*. An *if* clause needs no
41
- subjunctive (*if the funding was insufficient*); keep the subjunctive for demands, requests, and conditions contrary to
42
- fact (*requires that spending be offset*; *if the program were created now*).
43
- - **Projections:** *would* for outcomes under stated conditions (*if current laws remained in place...*), *will* for
44
- unconditional statements. Often better: present tense inside the projection (*In these projections, the deficit
45
- amounts to...*), passive (*is projected to climb*), or infinitive (*the analysis expects real GDP to grow*). Not "the
46
- analysis projects outlays to exceed"; OK *the analysis projects that outlays will exceed*.
47
- - **People-first language.** *people* (Not "persons"); *individual* only to contrast with a group. *U.S. residents* (or
48
- *U.S. citizens* when citizenship matters), not "Americans". *non–U.S. national* or a fuller description, not "alien"
49
- (except in legal terms). *people age 65 or older*, not "the elderly". *workers in blue-collar jobs*, not "blue-collar
50
- workers". *substance use disorder*. *crewed/staffed*, *work hours*, *personnel/workforce*, not "manned", "man-hours",
51
- "manpower".
52
- - **Pronouns for an unidentified person:** make it plural, rewrite without a pronoun, use singular *they*, or repeat
53
- the noun. An organization or legislative body is *it*, never "they".
54
- - **Openers and reference.** *And*/*But* may open a sentence sparingly for emphasis, never a paragraph. Few "There
55
- are"/"It is" openers. *first, second*, Not "firstly". No "as noted above"/"as discussed above". Point back with
56
- *that*, not "this" (*this* only for what is about to be mentioned, or inside bulleted lists and options). Never a bare
57
- "those" or "some": OK *people without health insurance*, *some workers without health insurance*.
58
-
59
- ## 2. Numbers
60
-
61
- - **Zero through nine in words; 10 and up in numerals** (ordinals too, no superscript): *two groups, 10 years, the
62
- seventh month, the 21st century*.
63
- - **Parallelism:** if any number in a same-category pair or series in the sentence or paragraph is 10+, all are
64
- numerals: *7 grants in 2025 and 47 grants from 2025 to 2030*. Other categories keep the general rule.
65
- - **Always numerals for**: percentages (*8 percent*), money (*$4 million*, *a 6 cent tax*), ratios (*4 to 1*, *a
66
- 4-to-1 ratio*), units of measure, hours of the day, and **ages of people**: *workers ages 25 to 54*, *people age 65 or
67
- older*, *a 30-year-old*, *workers in their 40s*, *the under-25 population* (Not "aged 25 to 54"). Ages of things and
68
- spans of time follow the general rule: *three-year period*, *six hours*.
69
- - **Sentence start:** spell out (*Twenty-five states...*); rewrite to avoid a large number or a year. OK: *Employment
70
- rose in 2019*; Not: "2019 saw a rise in employment".
71
- - **Large numbers:** commas for 1,000–999,999 (not years or page numbers); from 1 million up, numeral + word: *6 million
72
- people*, *$57.9 billion*.
73
- - **percent**, one word, spelled out in text and tables — never "%" or "per cent" in text. On a figure, a % or $ sign
74
- is acceptable when it makes the figure easier to read quickly. *Percent* only after a number (*23 percent of
75
- workers*); *percentage* for an unspecified share (*rose as a percentage of income*) and as the adjective (*percentage
76
- change*). Verb agrees with the "of" noun: *40 percent of the spending is*; *35 percent of the workers are*.
77
- - **share vs. percentage:** *share* only for a part of a whole (*the share of workers who were foreign-born*);
78
- *percentage* also compares two quantities where the first is not part of the second (*rent as a percentage of
79
- income*). Do not call values expressed as percentages "ratios".
80
- - **Percentage points for differences between percentages.** OK: *the rate rose by 3 percentage points, from 18 percent
81
- to 21 percent* (an increase of about 17 percent); Not: "rose 3 percent". Plural even below one (*0.2 percentage
82
- points*), except *1 percentage point* and *0.1 percentage point*. Prefer *a reduction of 9 percentage points* to *a 9
83
- percentage-point reduction*. Never "percentage points of" something (Not "2 percentage points of GDP").
84
- - **Avoid very large percentages** for changes: *more than quadrupled*, Not "increased by 325 percent". Never "times
85
- less/lower/smaller" or "times more/higher": OK *one-third as large*, *six times as much as*; *50 percent larger than*
86
- (Not "half again as large as").
87
- - **about/approximately/roughly** only when a number is rounded more than usual or less precise than numbers nearby
88
- (*about 20 percent* for a value of 22 percent; plain *22 percent* for 21.8). Not "around".
89
- - **Decimals:** leading zero below one (*0.3 percent*), except quantities that cannot exceed one (*p < .05*, *a
90
- probability of .95*). Seldom more than two places. Match precision across a series (*18.8 percent ... 20.0 percent*).
91
- - **Fractions:** use decimals for data (*26.5 percent*); fractions only for general statements (*one-third of the
92
- time*) or policy parameters stated as fractions. Hyphenate spelled-out fractions (*one-fifth*, *two and one-half
93
- times*). Do not switch between fractions and percentages for similar numbers (*67 percent agreed, and 12 percent were
94
- undecided*).
95
- - **Zero:** spell out in text. In tables and figures, *0* — never "0.0", "-0", or "0 percent"; a value that rounds to
96
- zero gets an asterisk and a note (*\* = between zero and 0.5 percent*), defined as narrowly as the values allow.
97
- - **Rounding note**, once, at the front: *Numbers in the text, tables, and figures may not add up to totals because of rounding.*
98
- - **Money:** $ sign for specific amounts, words for indefinite (*several million dollars*); a sum is singular (*$800
99
- million is...*); *in 2025 dollars* (Not "in constant 2025 dollars"); *current dollars* must be explained at first use.
100
- No hyphen with money modifiers (*a $3 million increase*). Cents: all *39 cents* in a passage of amounts under a
101
- dollar, or *$0.89* alongside dollar amounts.
102
- - **Inflation adjustment:** name the index at first use (*adjusted for inflation using the price index for personal
103
- consumption expenditures (PCE)*, or *using the CPI-U-RS*). Do not use *inflation* for a subset of prices
104
- (*wage growth*, Not "wage inflation").
105
- - **Values in two units:** second one in parentheses or commas, preceded by *or*: *employment rose by 400,000 (or 6
106
- percent)*.
107
- - **Ranges.** En dash only when the range precedes the noun (*the 2025–2029 period*), mostly for years and pages; *to*
108
- when it follows (*the period from 2025 to 2029*). For other values, rewrite (*a loss of $3.7 billion to $4.2
109
- billion*). Dates: *from . . . to* (Not "between 2010 and 2019"; never mix "from 2010–2019"); do not mix *from . . .
110
- through* and *from . . . to* in one document. After a verb, drop *from*: *costs were 31 to 40 percent more*. The unit
111
- need not be repeated (*7 to 11 percent*, *0.5 to 0.6 percentage points*), except for a change over time (*rose from
112
- 4.6 percent to 9.6 percent*). Repeat *million*/*billion* (*$3 billion to $4 billion*).
113
- - **Years** in full: *the 1990s*, *2007–2015* (Not "'90s", "2007–15"); no apostrophe in plural years.
114
- - **Fiscal vs. calendar year:** if a report mixes them, say which in the text; if most years are one type, put a note at
115
- the front (*Unless this report indicates otherwise, all years referred to are calendar years.*). Spell out and
116
- lowercase *fiscal year 2024* / *calendar year 2024* — never "FY 2024", "fiscal 2024", "CY 2024". Survey and most
117
- economic series are calendar-year; budget series are federal fiscal years. Say which in the front notes.
118
- - **Dates:** *October 1, 2023,* (comma after the year mid-sentence); *the October 2023 survey*; *In January 2026,* (comma
119
- after an introductory date). Seasons lowercase, no "of": *spring 2025*.
120
- - **Comparisons with counts:** *fewer* for countables, *less* for amounts — and *less* for percentages (*less than 60
121
- percent of people*) and single amounts (*less than 30 minutes*). *more than/over* and *less than/under* are
122
- interchangeable. *majority* only for countable things; prefer *most*. *by 2031* vs. *in 2031*: use *in* when the event
123
- happens in that year. *average annual* (Not "annualized"); *annual average* as a noun or column head. *another* only
124
- when repeating the same number; otherwise *an additional $X* / *$X more*.
125
-
126
- ## 3. Word usage for economic, labor and demographic analysis
127
-
128
- - **affect / effect / impact:** *affect* is the verb, *effect* the noun. Never *impact* as a verb; as a noun only for a
129
- major effect.
130
- - **compare with / compare to:** *compared with* for differences and similarities (nearly all comparisons in a data
131
- report); *compared to* only to liken unlike things; *comparable to*. In simple comparisons, prefer a comparative +
132
- *than*: OK *The rate was 5 percentage points higher in 2022 than in 2020*. "*X grew by 3.5 percent, compared with 2.9
133
- percent last year*" is acceptable. Compare like with like (Not "Compared with this fiscal year, the request...").
134
- *similar to*. *relative to* → *in relation to*, *compared with*, or a comparative. *contrast with* (different) / *in
135
- contrast to* (opposite).
136
- - **data** is always plural (*the data are*); *dataset* (one word), *data file*, *database*.
137
- - **because / since / as / while / with:** *since* for time, *because* for cause; never *as* for "because". *while* =
138
- at the same time; for contrast use *whereas*, *although*, or *but*. No *with* as a quasi-conjunction: Not "Employment
139
- rose, with women accounting for most of the gain"; OK *Employment rose; women accounted for most of the gain*. Comma
140
- before *because* after a negative clause.
141
- - **that / which:** *that* = restrictive, no comma; *, which* = nonrestrictive.
142
- - **based on / on the basis of:** *estimates based on survey data* (modifies a noun) vs. *the share was estimated on
143
- the basis of survey data* (modifies a verb). At the start of a sentence about the estimates, *On the basis of* (or better,
144
- *Using*).
145
- - **due to** only after a noun (*the decline due to...*); after a verb, *because of*.
146
- - **include / comprise / consist of:** *include* = partial list; *consists of*, *comprises*, *is composed of* =
147
- complete. Never "is comprised of".
148
- - **primary / primarily** for one thing only; for several use *key, main, major, principal*, *mainly, mostly*.
149
- - **mean / median:** a mean is an average; a median is the middle value. Always define on first reference and say which
150
- you report.
151
- - **if / whether:** *if* for a condition, *whether* for alternatives; *whether*, Not "whether or not" (unless it means
152
- "regardless"). *in which*, not "where", for circumstances.
153
- - **Describing changes.** Prefer the measure itself to "the level of". Then:
154
- - *rates* (employment, unemployment, participation, poverty), *prices*, *costs*: *higher/lower*, *rise/fall*,
155
- *increase/decrease* (Not "larger", "grow");
156
- - *earnings, income, wages*: *higher/lower* (Not "larger/smaller"); *rise, fall, grow, shrink, increase, decrease*;
157
- - *shares*, *deficits*, *benefits*: *larger/smaller* (Not "higher/lower"); *grow/shrink*, *increase/decrease* (Not
158
- "rise/fall");
159
- - *percentages*, *outlays*, *revenues*: either set;
160
- - *spending*: *higher/lower*; any verb;
161
- - *growth*: *faster/slower*; *accelerate/slow*.
162
- When in doubt, *increase/decrease* and *greater than/less than* fit all.
163
- - **rate / share / number of:** *rate* for a defined ratio; *share* for part of a
164
- whole; *the number of* + singular verb; *a number of* + plural (but prefer *some, several, many*). Define every rate at
165
- first use (numerator, denominator, universe).
166
- - **Labor terms:**
167
- - *labor force* (never hyphenated): people age 16 or older in the civilian noninstitutionalized population who have
168
- jobs or are unemployed (available for work and either actively seeking work or expecting to be recalled from a
169
- temporary layoff). *workforce* is one word.
170
- - *labor force participation rate*: the percentage of the civilian noninstitutionalized population age 16 or older
171
- that is in the labor force.
172
- - *unemployment rate*: the percentage of people in the labor force who are not working but are available for work and
173
- either actively seeking work or expecting recall.
174
- - *civilian noninstitutionalized population*: excludes active-duty armed forces and people in penal or mental
175
- institutions or homes for the elderly or infirm.
176
- - *discouraged workers* are not in the labor force.
177
- - The *household survey* (Current Population Survey) counts people employed; the *establishment survey* counts jobs.
178
- - **Macroeconomic and budget terms** (define each at first use): *real GDP* is GDP adjusted to remove the effects of
179
- inflation, in *chained 2017 dollars* ("chained", never "constant", for chained-dollar measures); *nominal* = current
180
- dollars. *Potential GDP* and *the output gap* (real GDP minus potential, as a percentage of potential) carry the
181
- estimating agency's name; a *positive* gap is output above potential (Not "a surplus"). Growth: *at an annual rate*
182
- (quarterly change), *fourth quarter to fourth quarter*, or *on a calendar-year basis*; say which every time. Prices
183
- *rise* and *fall*; the inflation *rate* is *higher* or *lower* (Not "inflation grew"); name the index (*PCE price
184
- index*, *CPI-U*; *core* = excluding food and energy). Interest-rate changes are in *percentage points* in text (basis
185
- points only in a table note). *the deficit* (outlays minus revenues), *debt held by the public*, *net interest*;
186
- deficits and debt are *larger/smaller* and *grow/shrink*, as a *percentage of GDP*. *seasonally adjusted* and *at an
187
- annual rate* go in the units line. *vintage*: the data as published on a given date (*as first reported*, *as
188
- revised*); never call a projection "data" (*the agency projects*).
189
- - **Poverty:** *federal poverty thresholds* (Census Bureau, statistical use) vs. *federal poverty guidelines* (HHS,
190
- program eligibility). "Poverty line/level" only if defined first.
191
- - **Income** is generally singular (*changes in income*); *after-tax* / *before-tax* (Not "posttax"); *individual income
192
- taxes* (Not "personal income taxes"). *employment-based health insurance* (Not "employer-sponsored"). Quintiles
193
- are *lowest (bottom), second, middle, fourth, highest (top)*, defined as fifths at first use.
194
- - **Hyphenation of common modifiers:**
195
- - always hyphenated: *full-time, part-time, well-off, blue-collar, white-collar, well-being, cost-effective,
196
- labor-intensive, tax-exempt, decision-maker*;
197
- - hyphenated only before a noun: *low-income/high-income families*, *long-term*, *short-term*, *better-off*,
198
- *private-sector*, *public-sector*, *out-of-pocket*;
199
- - never hyphenated: *labor force, health care, income tax, minimum wage* (but *minimum-wage worker*), *child tax
200
- credit*, *day care*.
201
- Write *families with low income* first, then *low-income families*. *people in the lowest income category* (no
202
- hyphen).
203
- - **Closed and fixed forms:** *onetime*, *underway*, *dataset*, *middle-aged*, *socioeconomic*, *postsecondary*, *childcare*, *nonprofit*, *nationwide*,
204
- *policymaker*, *homeowner*, *layoff* (n.) / *lay off* (v.), *take-up* (n.) / *take up* (v.), *follow-up* (n.).
205
- - **foreign-born / native-born:** hyphenate as compound adjectives before and after the
206
- noun, following Merriam-Webster. Define each at first use with the Census definition.
207
- - **prime-age:** hyphenate before a noun (*prime-age workers*); define once as *ages 25 to 54*.
208
- - **Race and ethnicity:** call them *racial and ethnic groups*. Capitalize *Black* and *White*; never use
209
- either as a noun for people (Not "Blacks", "Whites"). *Asian*, *Hispanic* (preferred to *Latino/Latina* for data
210
- categories), *African American*, *Native American* (*Indian* only in proper names), *Pacific Islander* — never
211
- hyphenated. List categories alphabetically (*Asian, Black, Hispanic, White*), with the composite group last (default
212
- name *Some Other Race or Multiracial*). Always explain the scheme: whether categories are mutually exclusive, that all
213
- people reporting Hispanic ethnicity are in *Hispanic*, which races make up the composite, and (with percentages if
214
- possible) whether one group dominates it.
215
- - **sex, not gender,** for survey classifications: *classified by age, sex, and family income*.
216
- - **Possessives, not nouns as adjectives:** *workers' earnings*, *the Census Bureau's data*, *hospitals' financial
217
- performance*, *the government's share*. At most two nouns in a row (three if two form a known compound): *income tax
218
- rates*, but *changes to income tax rates* (Not "income tax rate changes"). Singular noun after a plural possessive
219
- (*people whose income is low*; *homeowners ... their primary residence*). *census data*, *the census*.
220
- - **Other choices:** *past* (Not "historical"/"past history"); *during the past year* (Not "the last year"); *method* or
221
- *approach*, not "methodology" (*analytical method*); *analytical* (Not "analytic"); *selected occupations* (Not "select"); *often* only for repetition
222
- in time (Not "localities often reported" for "many localities reported"); *across* only for "throughout", not for
223
- "between/among"; *X, Y, or both*, never "and/or"; *only* right before the word it limits; *usage rates* but *use* as a
224
- noun; *cut* only when "reduce" vs. "eliminate" is clear; *a false range* ("ranging from bookkeeping to customer
225
- service") → *include*; *throughout* without "the entire".
226
- - **Spellings:** *toward, upward, judgment, adviser, sizable, preventive, forgo, email, website, web page, the web,
227
- internet* (lowercase), *PDF*. **Methods after results**, in an appendix if needed.
228
-
229
- ## 4. Capitalization and punctuation
230
-
231
- - **Headline style for titles and headings:** capitalize first, last, and major words; lowercase *a, an, the*, the
232
- conjunctions *and, or, but, nor, for, so, yet*, and prepositions of three letters or fewer (*in, of, to, for, per*)
233
- unless part of a verb (*Clean Up*); capitalize prepositions of four letters or more (*With, Through, From*). Both
234
- parts of a hyphenated compound, including prefix compounds (*Foreign-Born, Long-Term, Anti-Inflationary*); a
235
- hyphenated suffix stays lowercase. *Versus* spelled out, not italicized, capitalized in titles.
236
- - **Specific parts of a report capitalized:** *Figure 3, Table 2, Appendix A, Exhibit 4*; lowercase general references
237
- (*the figures in this report*; *see the appendix* when there is only one). *appendixes* (Not "appendices"). First
238
- callout in the form *see Figure 2* (Not "Figure 2 shows", "refer to Figure 2"); repeat *see* for each (*see Figure 2
239
- and see Figure 3*); *see Figure 4, top panel*.
240
- - **Lowercase general terms** (*federal, the federal government, state, the program, the act, executive branch*);
241
- capitalize proper names (*Social Security, Medicare, the Northeast, the South*; but *western Missouri*). Legislative
242
- bodies and agencies are capitalized when named in full (*the Census Bureau*, *the Bureau of Labor Statistics*).
243
- - **Serial comma:** *age, sex, and education*. No comma between two verbs sharing one subject.
244
- - **Semicolons** before *however/thus/therefore/indeed* joining clauses, and between series items with internal commas.
245
- *therefore* at a sentence start takes a comma.
246
- - **Colons** only after an independent clause; never between a verb or preposition and its object. Capitalize after the
247
- colon if a full sentence follows. Periods and commas go inside quotation marks; colons, semicolons, and dashes outside.
248
- - **Dashes:** em dash (—), no spaces, at most one or one pair per sentence. En dash (–) for ranges before a noun
249
- (*2010–2019*) and multiword compounds (*post–Great Recession*, *New Mexico–Arizona border*).
250
- - **Minus and multiplication signs:** a true minus (−) in text and figures; a hyphen in tables and table/figure notes. A
251
- true multiplication sign (×), never "x" or "*".
252
- - **Compound modifiers:** hyphenate before the noun (*employment-based insurance*, *cost-of-living adjustment*,
253
- *inflation-adjusted estimate*), open after (*an adjustment in the cost of living*); never after an *-ly* adverb
254
- (*federally backed*). Number + noun hyphenated (*five-year period*, *11-year lag*), but not money, percentages, or
255
- abbreviated units (*11 percent decline*). Series keep suspended hyphens (*low- and middle-income families*). Familiar
256
- open compounds stay open (*health care costs, income tax receipts, labor force*). *very* drops the hyphen (*a very low
257
- income family*). Verb phrases are open (*phase out*; *the phaseout*).
258
- - **Prefixes mostly closed** (*nonwhite, postsecondary, socioeconomic, midyear, prepandemic, coworker*); hyphen before a
259
- capital or number (*mid-2020s, sub-Saharan, post–Cold War*), in multiword compounds (*non-means-tested*), with *all-,
260
- ex-, self-*, and to prevent confusion (*re-create*). *bimonthly/semimonthly* → *every two months* / *twice a month*.
261
- - **Abbreviations:** use only for terms of three or more words that appear more than a few times. Spell out at first
262
- use with the abbreviation in parentheses (*American Community Survey (ACS)*), and again in each stand-alone part
263
- (summary, notes page, box, appendix, About This Document); in a footnote, introduce it only if used more than once
264
- there. Once introduced, the full name, the abbreviation, or *the survey* are interchangeable. *U.S.* only as an
265
- adjective; *the United States* as a noun. Plurals take no apostrophe (*the GSEs*); possessives do (*ACS's*). Most
266
- abbreviations take no periods. *the IRS* but *BLS, EPA, OMB, USDA* (no "the"); be consistent. Treat each source's
267
- dataset abbreviations (*ACS*, *CPS*, *MTS*, *CPI*) consistently across sections, spelled out at first use in every
268
- stand-alone part; after the first mention prefer plain names (*the household survey*). Spell out state names in text (*Fall River,
269
- Massachusetts*); in a crowded table use *Nev., Pa.* (postal codes only with zip codes).
270
- - **No Latin abbreviations in text:** *for example, that is, and others, and so forth, in itself, annually* — Not
271
- "e.g.", "i.e.", "et al.", "etc.", "per se", "per annum", "vis-à-vis". *per capita, ad hoc, a priori, de facto, versus*
272
- are not italicized.
273
- - **Quotation marks** for a word or term referred to as itself, at first reference only, and not after *called*,
274
- *known as*, *referred to as*. Sparingly for emphasis or jargon (rewriting is better).
275
- - **Lists:** items in a sentence go in alphabetical order unless another logic (size, importance) applies. Bulleted
276
- lists, sparingly: introduce with a complete sentence plus colon; items parallel, first word capitalized; no item longer
277
- than about one-third of a column. Sentences end with periods; fragments end with commas (semicolons if any item has
278
- internal commas), with *and*/*or* after the next-to-last item and a period on the last. Key-takeaway bullets may open
279
- with a boldface sentence-case lead-in. Number a list only for order or later reference.
280
-
281
- ## 5. Exhibits (tables and figures)
282
-
283
- - **Titles** define the data shown (*Employment Rates of People Ages 25 to 54*). Message titles (*Foreign-Born Workers'
284
- Share Has Grown*) are acceptable only if used consistently through the document. For subgroup comparisons, end the
285
- title with a *by* phrase: *Share of Veterans Ages 22 to 54, by VA Disability Rating*. Leave years out of the title
286
- when the axis or column heads show them, unless needed to tell exhibits apart. No two exhibits share a title. Either
287
- always spell out a name in titles or always abbreviate it (and define it in a note).
288
- - **Units line** under the title, sentence case: *Percent*, *Millions of people*, *2025 dollars*, *Percentage points*.
289
- The unit is not the idea: Not "Percentage change"; OK unit *Percent* with *Annual Change in ...* in the title. On a
290
- figure, the unit sits above the y-axis; a non-year x-axis unit goes below the x-axis. A different unit within a table
291
- goes in parentheses in the row's first entry or the column head.
292
- - **Stubs, column heads, labels, panel heads:** sentence case (capitalize only the first word; nothing in parentheses).
293
- Totals rows, column heads, and panel heads in boldface. Supplemental rows at the bottom follow a boldface stub
294
- *Addendum:* (formerly "Memorandum").
295
- - **Captions:** each figure generally gets one, adding reasons or implications rather than restating the chart; numbers
296
- in a caption should be visible in the figure.
297
- - **Notes, in this order:**
298
- 1. **Data source note.** *Data source: <Organization>.* for the organization's own data; *Data source: <Organization>,
299
- using data from [sources, alphabetically].* when the analysis modified others' data (growth rates, tabulations,
300
- fiscal-year totals, weighting, inflation adjustment — that is, most exhibits). When no organization is named: *Data source: Analyst calculations
301
- using data from [sources].* *Data sources: Bureau of Labor Statistics; Census Bureau.* for unmodified data. Name
302
- the survey or series when it helps, note revision dates for revised data, and say which source covers which part.
303
- A data-and-methods appendix may be cited: *using data described in Appendix A*. End with the URL where the
304
- exhibit's data are posted, if any. No abbreviations in source notes (*the staff of the Joint Committee on
305
- Taxation*; *Bureau of Labor Statistics*, Not "BLS" at first mention).
306
- 2. **General notes**, broadest first; in multipanel exhibits, in panel order.
307
- 3. **Abbreviations note:** abbreviations alphabetically, then *n.a. = not applicable*, *N.A. = not available*, *n.e. =
308
- not estimated*, then asterisk notations (*\* = between zero and 0.5 percent*). *GDP* needs no definition.
309
- 4. **Footnotes** to specific cells or labels, with superscript lowercase letters ordered left to right, top to bottom.
310
- - **Recessions** shaded in figures get the note *Shaded areas indicate recessions as dated by the NBER* (builder adds it).
311
- - **Referring to a stub or label in text:** quote it as capitalized in the exhibit, with a singular verb (*"Other
312
- sources" consists of...*), or describe it generically to avoid the quotation marks.
313
- - Rounding note once at the front; table zeros per Section 2.
314
-
315
- **Standard pattern for exhibits:**
316
- - Label *Exhibit n.* (or *Figure n.*); number consecutively; appendix exhibits get their own sequence (*Figure A-1*).
317
- - **Data source line:** name the original agency and the dataset or series, then any intermediary: *Data source:
318
- Analyst calculations using data from the Bureau of Labor Statistics (Current Population Survey, series LNS14000000),
319
- retrieved October 20, 2026.* For data reached through an aggregator, *... from the Bureau of Economic Analysis,
320
- retrieved from FRED, Federal Reserve Bank of St. Louis*; for microdata, *... as provided by IPUMS USA*. With several
321
- sources, list them alphabetically and say which covers which part. Or *Data source: <Organization>, using data from
322
- …* when an organization is named. Give the retrieval date or vintage for data that are revised. The audit checks that
323
- every source line names a source the report used.
324
- - **General notes:** full sentences ending in periods, in this order: the measure and universe (*civilian employees
325
- on board at the end of September*, *people ages 25 to 54*); definitions; period basis (*Years are federal fiscal
326
- years, which run from October 1 to September 30.*); seasonal adjustment; weighting; dollar year and price index;
327
- preliminary, projected or missing values (*Data for October 2025 were not collected.*); redaction or suppression;
328
- sign conventions (*A positive value is a deficit.*); the vintage when not the latest; recession shading (the builder
329
- adds the note).
330
- - **Text callouts:** *see Exhibit 2*; each section opens with its key finding and the exhibit supports it.
331
-
332
- ## 6. Footnotes and references
333
-
334
- **Footnotes in text:** use them to cite an authority or give a brief explanation (or a long definition), and keep them
335
- few — if most readers would ask the question, answer it in the text. Number consecutively, restarting in the summary,
336
- each chapter, each appendix, and each box. Place the number at the end of the sentence, after the punctuation, one per
337
- sentence (combine sources into one note); every footnote ends with a period. Give the full reference each time (no
338
- short-form repeats); *ibid.* (not italicized) for a source identical to the preceding note. Multiple references:
339
- reverse chronological order, separated by semicolons. Omit "the" before organizations, periodicals, and publishers in
340
- citations. Use headline-style capitalization for titles but keep the source's own hyphenation (en dash for year ranges).
341
-
342
- **Reference format:** Author, *Title*, extra information (Publisher, Date), pages, URL.
343
- - Author: first and last names; more than three authors → *and others* (Not "et al."); an organization can be the
344
- author.
345
- - Titles: italics for books, reports, and journals; quotation marks and roman type for articles, web pages, and
346
- datasets.
347
- - Date in parentheses; a web page with no date gets *(accessed Month Day, Year)*.
348
- - URL: drop "http://" when the address has "www."; link to a summary page rather than a PDF, and give a PDF's file size
349
- if you must link to one (*(3 MB)*); DOI for journal articles; never a URL alone.
350
- - Court cases in italics with italic *v.*, naming the court and year in text.
351
- - Examples: *Bureau of Labor Statistics, "Foreign-Born Workers: Labor Force Characteristics—2023," news release
352
- (May 2024), www.bls.gov/news.release/forbrn.nr0.htm.* — *Rose M. Kreider and Diana B. Elliott, America's Families and
353
- Living Arrangements: 2007, Current Population Reports P20-561 (Census Bureau, September 2009), www.census.gov/...* —
354
- *Kenneth A. Couch and Dana W. Placzek, "Earnings Losses of Displaced Workers Revisited," American Economic Review,
355
- vol. 100, no. 1 (March 2010), pp. 572–589, https://doi.org/10.1257/aer.100.1.572.* — web page or data table:
356
- *Organization, "Page Title" (date or accessed date), Table n, URL.*
357
- - **Datasets and series** (data-table rule)**:** *Agency, "Dataset or Table Title" (dataset, accessed Month Day,
358
- Year), Table n, URL.* Copy the citation the source asks for from `data/<id>/README.md` (each pack writes it, for
359
- example a series citation with its ID, an extract's DOI and version, or a statement's table number). Required notices
360
- (API terms such as "uses the ... API but is not endorsed or certified by ...", or a statement that the agency cannot
361
- vouch for derived analyses) are added by the report builder from each source's policy; never drop them and never use
362
- an agency's logo.
363
-
364
- ## 7. Editor's checklist
365
-
366
- 1. No "we"/"our"/"I"; the organization by name (full name at first reference in each stand-alone part) or the third
367
- person (*this analysis*); *estimates that*; no "predicts"/"assumed" for the analysis's own estimates; no
368
- contractions; no unrequested advice; no "reform"?
369
- 2. Every technical term, rate, universe, mean/median, *real*, and abbreviation defined at first use — and again in each
370
- stand-alone section?
371
- 3. Zero–nine spelled out, 10+ numerals, same-category series consistent; no sentence starts with a numeral or a year?
372
- 4. *percent* spelled out; *percentage points* for differences (never "of GDP"); *share* only for part of a whole; no
373
- "times less"; no huge percentage changes?
374
- 5. Ranges: en dash only before a noun; *from X to Y* for dates (no "between"); unit repeated only for a change over time;
375
- years in full?
376
- 6. Ages as *ages 25 to 54*, *age 65 or older*, in numerals; no "the elderly"?
377
- 7. Calendar-year, rounding, retrieval-date and vintage notes at the front; dollar year and price index named (*in
378
- 2025 dollars*); preliminary and projected values called so?
379
- 8. Hyphens: *full-time/part-time/well-off* always; *low-income* only before a noun, after *families with low income* at
380
- first use; none after *-ly*; *very* drops it?
381
- 9. Word choices: *data are*, *dataset*, *compared with* (or *than*), *affect/effect*, *because* (not "since"/"as"),
382
- *whereas/although* (not "while") for contrast, no *with* clauses, *that/which* commas, *fewer/less*, *due to* only
383
- after a noun, *analytical*, *method*?
384
- 10. Change verbs fit the measure: rates and wages *higher/lower, rise/fall*; shares *larger/smaller, grow/shrink*;
385
- growth *faster/slower*?
386
- 11. Race and ethnicity: *Black*, *White* capitalized and never nouns; categories alphabetical with the composite last;
387
- scheme explained; *sex* for the survey variable?
388
- 12. Pronouns: no "he or she"; singular *they* or a plural rewrite; organizations are *it*?
389
- 13. Titles and headings in headline style (*Anti-Inflationary*); serial comma; first callouts as *see Exhibit n*?
390
- 14. Every exhibit: number, title (with *by* for subgroups), units line, then notes in order — *Data source:* line (no
391
- abbreviations, sources alphabetical), general notes (universe, definitions, weights, years), abbreviations,
392
- lettered footnotes; stubs in sentence case?
393
- 15. Table zeros as *0* or an asterisk with a narrow note; true minus in text and figures, hyphen in tables; decimals
394
- consistent within each series?
395
- 16. Footnotes: full references ending in periods, one per sentence, after the punctuation; URLs to summary pages; PDF
396
- sizes noted?
397
- 17. None of "e.g.", "i.e.", "etc.", "et al.", "utilize", "prior to", "regarding", "upon", "around" for approximately,
398
- "appear to", "lion's share", "Americans", "and/or", "methodology", "data set", "Internet"?
1
+ # Style guide for data reports
2
+
3
+ The rules that matter for a short data product: summary, exhibit-driven sections, notes and sources, a
4
+ data-and-methods appendix, and an optional About This Document. Convention below: **OK** = correct,
5
+ **Not** = incorrect. Spelling follows the first entry in Merriam-Webster's online dictionary (www.m-w.com);
6
+ otherwise defer to *The Chicago Manual of Style*. These rules distill the house style of U.S. statistical
7
+ and policy publishers; they are organization-neutral. Where an organization is named in a report
8
+ (`organization` in `report.json`), the examples below write `<Organization>`. One guide for every source;
9
+ a pack's `source.md` adds only its own names, units and citation forms (for example the dataset to cite).
10
+
11
+ ## 1. Tone and voice
12
+
13
+ - **Write for an intelligent, well-informed reader** with no formal economics training. Do not
14
+ talk down; avoid jargon; explain each concept as it comes up.
15
+ - **Jargon only when essential for precision, defined at first use.** Short definitions go in parentheses right after
16
+ the term (*the quintile (one-fifth) of households with the highest earnings*); longer ones in a separate sentence or a
17
+ footnote. Or avoid the term altogether. Always define: *mean*, *median*, *quintile*, *standard deviation*,
18
+ *transfers*, *nominal*, *real* (*real earnings (that is, earnings adjusted to remove the effects of inflation)*).
19
+ - **Plain English; omit needless words.** OK: *because, now, to, about, use, before, after, later, if, can, help,
20
+ spending, except for, daily, end*. Not: "due to the fact that", "at the present time", "in order to", "for the purpose
21
+ of", "regarding/concerning", "utilize", "prior to", "subsequent to", "upon", "expenditures", "facilitate", "is able
22
+ to", "in the event that", "with the exception of", "period of time", "a larger number of".
23
+ - **Active voice.** Passive only to stress the action or when the actor is unknown or unimportant (projections
24
+ often qualify: *Employment is projected to grow*). *will likely* is fine. **No contractions.** Cut *fairly, quite, rather, somewhat*,
25
+ *very* (unless it makes a needed distinction), *lion's share*, *appear to/seem to*. Avoid emphatic *do/did*.
26
+ - **Who speaks.** Never "we", "our" or "I" in a report or paper. When the product names an organization, use its
27
+ name: *<Organization> estimates that …* (the full name at first reference in each stand-alone part, then the
28
+ short name or abbreviation; never "the" before an abbreviation). When no organization is named, write in the
29
+ third person: *this analysis*, *the estimates*, *the data show*, *the employment rate was …*. The verb
30
+ *estimates* takes *that*; the noun takes the possessive (*the analysis's estimates of the share*).
31
+ - **Say what was done, in plain verbs.** *estimates*, *projects*, *expects*, *finds*, *shows* — not "predicts".
32
+ *assume* is for stated policy or scenario specifications, not for the analyst's own estimates (*the estimates
33
+ are based on …*, *in this analysis's assessment …*). A model or scenario does not "assume"; it *reflects the
34
+ assumption*. *forecast* only for economic projections (past tense *forecast*, Not "forecasted").
35
+ - **Neutral tone.** Report what the data show and what a change would do. Do not add policy advice unless the user
36
+ asked for recommendations, and then keep them in a clearly labeled section. Avoid *reform* (implies improvement);
37
+ use *change*. Describe associations; do not imply causation the analysis cannot support.
38
+ - **Conditional for anything hypothetical**: *the option would raise...*; *might* (Not *may*) for hypotheticals. *may have*
39
+ = writer does not know; *might have* = could have happened, but did not. Keep tenses in sequence: *if borrowers
40
+ defaulted, the lenders would cover...* / *if borrowers default, the lenders will cover...*. An *if* clause needs no
41
+ subjunctive (*if the funding was insufficient*); keep the subjunctive for demands, requests, and conditions contrary to
42
+ fact (*requires that spending be offset*; *if the program were created now*).
43
+ - **Projections:** *would* for outcomes under stated conditions (*if current laws remained in place...*), *will* for
44
+ unconditional statements. Often better: present tense inside the projection (*In these projections, the deficit
45
+ amounts to...*), passive (*is projected to climb*), or infinitive (*the analysis expects real GDP to grow*). Not "the
46
+ analysis projects outlays to exceed"; OK *the analysis projects that outlays will exceed*.
47
+ - **People-first language.** *people* (Not "persons"); *individual* only to contrast with a group. *U.S. residents* (or
48
+ *U.S. citizens* when citizenship matters), not "Americans". *non–U.S. national* or a fuller description, not "alien"
49
+ (except in legal terms). *people age 65 or older*, not "the elderly". *workers in blue-collar jobs*, not "blue-collar
50
+ workers". *substance use disorder*. *crewed/staffed*, *work hours*, *personnel/workforce*, not "manned", "man-hours",
51
+ "manpower".
52
+ - **Pronouns for an unidentified person:** make it plural, rewrite without a pronoun, use singular *they*, or repeat
53
+ the noun. An organization or legislative body is *it*, never "they".
54
+ - **Openers and reference.** *And*/*But* may open a sentence sparingly for emphasis, never a paragraph. Few "There
55
+ are"/"It is" openers. *first, second*, Not "firstly". No "as noted above"/"as discussed above". Point back with
56
+ *that*, not "this" (*this* only for what is about to be mentioned, or inside bulleted lists and options). Never a bare
57
+ "those" or "some": OK *people without health insurance*, *some workers without health insurance*.
58
+
59
+ ## 2. Numbers
60
+
61
+ - **Zero through nine in words; 10 and up in numerals** (ordinals too, no superscript): *two groups, 10 years, the
62
+ seventh month, the 21st century*.
63
+ - **Parallelism:** if any number in a same-category pair or series in the sentence or paragraph is 10+, all are
64
+ numerals: *7 grants in 2025 and 47 grants from 2025 to 2030*. Other categories keep the general rule.
65
+ - **Always numerals for**: percentages (*8 percent*), money (*$4 million*, *a 6 cent tax*), ratios (*4 to 1*, *a
66
+ 4-to-1 ratio*), units of measure, hours of the day, and **ages of people**: *workers ages 25 to 54*, *people age 65 or
67
+ older*, *a 30-year-old*, *workers in their 40s*, *the under-25 population* (Not "aged 25 to 54"). Ages of things and
68
+ spans of time follow the general rule: *three-year period*, *six hours*.
69
+ - **Sentence start:** spell out (*Twenty-five states...*); rewrite to avoid a large number or a year. OK: *Employment
70
+ rose in 2019*; Not: "2019 saw a rise in employment".
71
+ - **Large numbers:** commas for 1,000–999,999 (not years or page numbers); from 1 million up, numeral + word: *6 million
72
+ people*, *$57.9 billion*.
73
+ - **percent**, one word, spelled out in text and tables — never "%" or "per cent" in text. On a figure, a % or $ sign
74
+ is acceptable when it makes the figure easier to read quickly. *Percent* only after a number (*23 percent of
75
+ workers*); *percentage* for an unspecified share (*rose as a percentage of income*) and as the adjective (*percentage
76
+ change*). Verb agrees with the "of" noun: *40 percent of the spending is*; *35 percent of the workers are*.
77
+ - **share vs. percentage:** *share* only for a part of a whole (*the share of workers who were foreign-born*);
78
+ *percentage* also compares two quantities where the first is not part of the second (*rent as a percentage of
79
+ income*). Do not call values expressed as percentages "ratios".
80
+ - **Percentage points for differences between percentages.** OK: *the rate rose by 3 percentage points, from 18 percent
81
+ to 21 percent* (an increase of about 17 percent); Not: "rose 3 percent". Plural even below one (*0.2 percentage
82
+ points*), except *1 percentage point* and *0.1 percentage point*. Prefer *a reduction of 9 percentage points* to *a 9
83
+ percentage-point reduction*. Never "percentage points of" something (Not "2 percentage points of GDP").
84
+ - **Avoid very large percentages** for changes: *more than quadrupled*, Not "increased by 325 percent". Never "times
85
+ less/lower/smaller" or "times more/higher": OK *one-third as large*, *six times as much as*; *50 percent larger than*
86
+ (Not "half again as large as").
87
+ - **about/approximately/roughly** only when a number is rounded more than usual or less precise than numbers nearby
88
+ (*about 20 percent* for a value of 22 percent; plain *22 percent* for 21.8). Not "around".
89
+ - **Decimals:** leading zero below one (*0.3 percent*), except quantities that cannot exceed one (*p < .05*, *a
90
+ probability of .95*). Seldom more than two places. Match precision across a series (*18.8 percent ... 20.0 percent*).
91
+ - **Fractions:** use decimals for data (*26.5 percent*); fractions only for general statements (*one-third of the
92
+ time*) or policy parameters stated as fractions. Hyphenate spelled-out fractions (*one-fifth*, *two and one-half
93
+ times*). Do not switch between fractions and percentages for similar numbers (*67 percent agreed, and 12 percent were
94
+ undecided*).
95
+ - **Zero:** spell out in text. In tables and figures, *0* — never "0.0", "-0", or "0 percent"; a value that rounds to
96
+ zero gets an asterisk and a note (*\* = between zero and 0.5 percent*), defined as narrowly as the values allow.
97
+ - **Rounding note**, once, at the front: *Numbers in the text, tables, and figures may not add up to totals because of rounding.*
98
+ - **Money:** $ sign for specific amounts, words for indefinite (*several million dollars*); a sum is singular (*$800
99
+ million is...*); *in 2025 dollars* (Not "in constant 2025 dollars"); *current dollars* must be explained at first use.
100
+ No hyphen with money modifiers (*a $3 million increase*). Cents: all *39 cents* in a passage of amounts under a
101
+ dollar, or *$0.89* alongside dollar amounts.
102
+ - **Inflation adjustment:** name the index at first use (*adjusted for inflation using the price index for personal
103
+ consumption expenditures (PCE)*, or *using the CPI-U-RS*). Do not use *inflation* for a subset of prices
104
+ (*wage growth*, Not "wage inflation").
105
+ - **Values in two units:** second one in parentheses or commas, preceded by *or*: *employment rose by 400,000 (or 6
106
+ percent)*.
107
+ - **Ranges.** En dash only when the range precedes the noun (*the 2025–2029 period*), mostly for years and pages; *to*
108
+ when it follows (*the period from 2025 to 2029*). For other values, rewrite (*a loss of $3.7 billion to $4.2
109
+ billion*). Dates: *from . . . to* (Not "between 2010 and 2019"; never mix "from 2010–2019"); do not mix *from . . .
110
+ through* and *from . . . to* in one document. After a verb, drop *from*: *costs were 31 to 40 percent more*. The unit
111
+ need not be repeated (*7 to 11 percent*, *0.5 to 0.6 percentage points*), except for a change over time (*rose from
112
+ 4.6 percent to 9.6 percent*). Repeat *million*/*billion* (*$3 billion to $4 billion*).
113
+ - **Years** in full: *the 1990s*, *2007–2015* (Not "'90s", "2007–15"); no apostrophe in plural years.
114
+ - **Fiscal vs. calendar year:** if a report mixes them, say which in the text; if most years are one type, put a note at
115
+ the front (*Unless this report indicates otherwise, all years referred to are calendar years.*). Spell out and
116
+ lowercase *fiscal year 2024* / *calendar year 2024* — never "FY 2024", "fiscal 2024", "CY 2024". Survey and most
117
+ economic series are calendar-year; budget series are federal fiscal years. Say which in the front notes.
118
+ - **Dates:** *October 1, 2023,* (comma after the year mid-sentence); *the October 2023 survey*; *In January 2026,* (comma
119
+ after an introductory date). Seasons lowercase, no "of": *spring 2025*.
120
+ - **Comparisons with counts:** *fewer* for countables, *less* for amounts — and *less* for percentages (*less than 60
121
+ percent of people*) and single amounts (*less than 30 minutes*). *more than/over* and *less than/under* are
122
+ interchangeable. *majority* only for countable things; prefer *most*. *by 2031* vs. *in 2031*: use *in* when the event
123
+ happens in that year. *average annual* (Not "annualized"); *annual average* as a noun or column head. *another* only
124
+ when repeating the same number; otherwise *an additional $X* / *$X more*.
125
+
126
+ ## 3. Word usage for economic, labor and demographic analysis
127
+
128
+ - **affect / effect / impact:** *affect* is the verb, *effect* the noun. Never *impact* as a verb; as a noun only for a
129
+ major effect.
130
+ - **compare with / compare to:** *compared with* for differences and similarities (nearly all comparisons in a data
131
+ report); *compared to* only to liken unlike things; *comparable to*. In simple comparisons, prefer a comparative +
132
+ *than*: OK *The rate was 5 percentage points higher in 2022 than in 2020*. "*X grew by 3.5 percent, compared with 2.9
133
+ percent last year*" is acceptable. Compare like with like (Not "Compared with this fiscal year, the request...").
134
+ *similar to*. *relative to* → *in relation to*, *compared with*, or a comparative. *contrast with* (different) / *in
135
+ contrast to* (opposite).
136
+ - **data** is always plural (*the data are*); *dataset* (one word), *data file*, *database*.
137
+ - **because / since / as / while / with:** *since* for time, *because* for cause; never *as* for "because". *while* =
138
+ at the same time; for contrast use *whereas*, *although*, or *but*. No *with* as a quasi-conjunction: Not "Employment
139
+ rose, with women accounting for most of the gain"; OK *Employment rose; women accounted for most of the gain*. Comma
140
+ before *because* after a negative clause.
141
+ - **that / which:** *that* = restrictive, no comma; *, which* = nonrestrictive.
142
+ - **based on / on the basis of:** *estimates based on survey data* (modifies a noun) vs. *the share was estimated on
143
+ the basis of survey data* (modifies a verb). At the start of a sentence about the estimates, *On the basis of* (or better,
144
+ *Using*).
145
+ - **due to** only after a noun (*the decline due to...*); after a verb, *because of*.
146
+ - **include / comprise / consist of:** *include* = partial list; *consists of*, *comprises*, *is composed of* =
147
+ complete. Never "is comprised of".
148
+ - **primary / primarily** for one thing only; for several use *key, main, major, principal*, *mainly, mostly*.
149
+ - **mean / median:** a mean is an average; a median is the middle value. Always define on first reference and say which
150
+ you report.
151
+ - **if / whether:** *if* for a condition, *whether* for alternatives; *whether*, Not "whether or not" (unless it means
152
+ "regardless"). *in which*, not "where", for circumstances.
153
+ - **Describing changes.** Prefer the measure itself to "the level of". Then:
154
+ - *rates* (employment, unemployment, participation, poverty), *prices*, *costs*: *higher/lower*, *rise/fall*,
155
+ *increase/decrease* (Not "larger", "grow");
156
+ - *earnings, income, wages*: *higher/lower* (Not "larger/smaller"); *rise, fall, grow, shrink, increase, decrease*;
157
+ - *shares*, *deficits*, *benefits*: *larger/smaller* (Not "higher/lower"); *grow/shrink*, *increase/decrease* (Not
158
+ "rise/fall");
159
+ - *percentages*, *outlays*, *revenues*: either set;
160
+ - *spending*: *higher/lower*; any verb;
161
+ - *growth*: *faster/slower*; *accelerate/slow*.
162
+ When in doubt, *increase/decrease* and *greater than/less than* fit all.
163
+ - **rate / share / number of:** *rate* for a defined ratio; *share* for part of a
164
+ whole; *the number of* + singular verb; *a number of* + plural (but prefer *some, several, many*). Define every rate at
165
+ first use (numerator, denominator, universe).
166
+ - **Labor terms:**
167
+ - *labor force* (never hyphenated): people age 16 or older in the civilian noninstitutionalized population who have
168
+ jobs or are unemployed (available for work and either actively seeking work or expecting to be recalled from a
169
+ temporary layoff). *workforce* is one word.
170
+ - *labor force participation rate*: the percentage of the civilian noninstitutionalized population age 16 or older
171
+ that is in the labor force.
172
+ - *unemployment rate*: the percentage of people in the labor force who are not working but are available for work and
173
+ either actively seeking work or expecting recall.
174
+ - *civilian noninstitutionalized population*: excludes active-duty armed forces and people in penal or mental
175
+ institutions or homes for the elderly or infirm.
176
+ - *discouraged workers* are not in the labor force.
177
+ - The *household survey* (Current Population Survey) counts people employed; the *establishment survey* counts jobs.
178
+ - **Macroeconomic and budget terms** (define each at first use): *real GDP* is GDP adjusted to remove the effects of
179
+ inflation, in *chained 2017 dollars* ("chained", never "constant", for chained-dollar measures); *nominal* = current
180
+ dollars. *Potential GDP* and *the output gap* (real GDP minus potential, as a percentage of potential) carry the
181
+ estimating agency's name; a *positive* gap is output above potential (Not "a surplus"). Growth: *at an annual rate*
182
+ (quarterly change), *fourth quarter to fourth quarter*, or *on a calendar-year basis*; say which every time. Prices
183
+ *rise* and *fall*; the inflation *rate* is *higher* or *lower* (Not "inflation grew"); name the index (*PCE price
184
+ index*, *CPI-U*; *core* = excluding food and energy). Interest-rate changes are in *percentage points* in text (basis
185
+ points only in a table note). *the deficit* (outlays minus revenues), *debt held by the public*, *net interest*;
186
+ deficits and debt are *larger/smaller* and *grow/shrink*, as a *percentage of GDP*. *seasonally adjusted* and *at an
187
+ annual rate* go in the units line. *vintage*: the data as published on a given date (*as first reported*, *as
188
+ revised*); never call a projection "data" (*the agency projects*).
189
+ - **Poverty:** *federal poverty thresholds* (Census Bureau, statistical use) vs. *federal poverty guidelines* (HHS,
190
+ program eligibility). "Poverty line/level" only if defined first.
191
+ - **Income** is generally singular (*changes in income*); *after-tax* / *before-tax* (Not "posttax"); *individual income
192
+ taxes* (Not "personal income taxes"). *employment-based health insurance* (Not "employer-sponsored"). Quintiles
193
+ are *lowest (bottom), second, middle, fourth, highest (top)*, defined as fifths at first use.
194
+ - **Hyphenation of common modifiers:**
195
+ - always hyphenated: *full-time, part-time, well-off, blue-collar, white-collar, well-being, cost-effective,
196
+ labor-intensive, tax-exempt, decision-maker*;
197
+ - hyphenated only before a noun: *low-income/high-income families*, *long-term*, *short-term*, *better-off*,
198
+ *private-sector*, *public-sector*, *out-of-pocket*;
199
+ - never hyphenated: *labor force, health care, income tax, minimum wage* (but *minimum-wage worker*), *child tax
200
+ credit*, *day care*.
201
+ Write *families with low income* first, then *low-income families*. *people in the lowest income category* (no
202
+ hyphen).
203
+ - **Closed and fixed forms:** *onetime*, *underway*, *dataset*, *middle-aged*, *socioeconomic*, *postsecondary*, *childcare*, *nonprofit*, *nationwide*,
204
+ *policymaker*, *homeowner*, *layoff* (n.) / *lay off* (v.), *take-up* (n.) / *take up* (v.), *follow-up* (n.).
205
+ - **foreign-born / native-born:** hyphenate as compound adjectives before and after the
206
+ noun, following Merriam-Webster. Define each at first use with the Census definition.
207
+ - **prime-age:** hyphenate before a noun (*prime-age workers*); define once as *ages 25 to 54*.
208
+ - **Race and ethnicity:** call them *racial and ethnic groups*. Capitalize *Black* and *White*; never use
209
+ either as a noun for people (Not "Blacks", "Whites"). *Asian*, *Hispanic* (preferred to *Latino/Latina* for data
210
+ categories), *African American*, *Native American* (*Indian* only in proper names), *Pacific Islander* — never
211
+ hyphenated. List categories alphabetically (*Asian, Black, Hispanic, White*), with the composite group last (default
212
+ name *Some Other Race or Multiracial*). Always explain the scheme: whether categories are mutually exclusive, that all
213
+ people reporting Hispanic ethnicity are in *Hispanic*, which races make up the composite, and (with percentages if
214
+ possible) whether one group dominates it.
215
+ - **sex, not gender,** for survey classifications: *classified by age, sex, and family income*.
216
+ - **Possessives, not nouns as adjectives:** *workers' earnings*, *the Census Bureau's data*, *hospitals' financial
217
+ performance*, *the government's share*. At most two nouns in a row (three if two form a known compound): *income tax
218
+ rates*, but *changes to income tax rates* (Not "income tax rate changes"). Singular noun after a plural possessive
219
+ (*people whose income is low*; *homeowners ... their primary residence*). *census data*, *the census*.
220
+ - **Other choices:** *past* (Not "historical"/"past history"); *during the past year* (Not "the last year"); *method* or
221
+ *approach*, not "methodology" (*analytical method*); *analytical* (Not "analytic"); *selected occupations* (Not "select"); *often* only for repetition
222
+ in time (Not "localities often reported" for "many localities reported"); *across* only for "throughout", not for
223
+ "between/among"; *X, Y, or both*, never "and/or"; *only* right before the word it limits; *usage rates* but *use* as a
224
+ noun; *cut* only when "reduce" vs. "eliminate" is clear; *a false range* ("ranging from bookkeeping to customer
225
+ service") → *include*; *throughout* without "the entire".
226
+ - **Spellings:** *toward, upward, judgment, adviser, sizable, preventive, forgo, email, website, web page, the web,
227
+ internet* (lowercase), *PDF*. **Methods after results**, in an appendix if needed.
228
+
229
+ ## 4. Capitalization and punctuation
230
+
231
+ - **Headline style for titles and headings:** capitalize first, last, and major words; lowercase *a, an, the*, the
232
+ conjunctions *and, or, but, nor, for, so, yet*, and prepositions of three letters or fewer (*in, of, to, for, per*)
233
+ unless part of a verb (*Clean Up*); capitalize prepositions of four letters or more (*With, Through, From*). Both
234
+ parts of a hyphenated compound, including prefix compounds (*Foreign-Born, Long-Term, Anti-Inflationary*); a
235
+ hyphenated suffix stays lowercase. *Versus* spelled out, not italicized, capitalized in titles.
236
+ - **Specific parts of a report capitalized:** *Figure 3, Table 2, Appendix A, Exhibit 4*; lowercase general references
237
+ (*the figures in this report*; *see the appendix* when there is only one). *appendixes* (Not "appendices"). First
238
+ callout in the form *see Figure 2* (Not "Figure 2 shows", "refer to Figure 2"); repeat *see* for each (*see Figure 2
239
+ and see Figure 3*); *see Figure 4, top panel*.
240
+ - **Lowercase general terms** (*federal, the federal government, state, the program, the act, executive branch*);
241
+ capitalize proper names (*Social Security, Medicare, the Northeast, the South*; but *western Missouri*). Legislative
242
+ bodies and agencies are capitalized when named in full (*the Census Bureau*, *the Bureau of Labor Statistics*).
243
+ - **Serial comma:** *age, sex, and education*. No comma between two verbs sharing one subject.
244
+ - **Semicolons** before *however/thus/therefore/indeed* joining clauses, and between series items with internal commas.
245
+ *therefore* at a sentence start takes a comma.
246
+ - **Colons** only after an independent clause; never between a verb or preposition and its object. Capitalize after the
247
+ colon if a full sentence follows. Periods and commas go inside quotation marks; colons, semicolons, and dashes outside.
248
+ - **Dashes:** em dash (—), no spaces, at most one or one pair per sentence. En dash (–) for ranges before a noun
249
+ (*2010–2019*) and multiword compounds (*post–Great Recession*, *New Mexico–Arizona border*).
250
+ - **Minus and multiplication signs:** a true minus (−) in text and figures; a hyphen in tables and table/figure notes. A
251
+ true multiplication sign (×), never "x" or "*".
252
+ - **Compound modifiers:** hyphenate before the noun (*employment-based insurance*, *cost-of-living adjustment*,
253
+ *inflation-adjusted estimate*), open after (*an adjustment in the cost of living*); never after an *-ly* adverb
254
+ (*federally backed*). Number + noun hyphenated (*five-year period*, *11-year lag*), but not money, percentages, or
255
+ abbreviated units (*11 percent decline*). Series keep suspended hyphens (*low- and middle-income families*). Familiar
256
+ open compounds stay open (*health care costs, income tax receipts, labor force*). *very* drops the hyphen (*a very low
257
+ income family*). Verb phrases are open (*phase out*; *the phaseout*).
258
+ - **Prefixes mostly closed** (*nonwhite, postsecondary, socioeconomic, midyear, prepandemic, coworker*); hyphen before a
259
+ capital or number (*mid-2020s, sub-Saharan, post–Cold War*), in multiword compounds (*non-means-tested*), with *all-,
260
+ ex-, self-*, and to prevent confusion (*re-create*). *bimonthly/semimonthly* → *every two months* / *twice a month*.
261
+ - **Abbreviations:** use only for terms of three or more words that appear more than a few times. Spell out at first
262
+ use with the abbreviation in parentheses (*American Community Survey (ACS)*), and again in each stand-alone part
263
+ (summary, notes page, box, appendix, About This Document); in a footnote, introduce it only if used more than once
264
+ there. Once introduced, the full name, the abbreviation, or *the survey* are interchangeable. *U.S.* only as an
265
+ adjective; *the United States* as a noun. Plurals take no apostrophe (*the GSEs*); possessives do (*ACS's*). Most
266
+ abbreviations take no periods. *the IRS* but *BLS, EPA, OMB, USDA* (no "the"); be consistent. Treat each source's
267
+ dataset abbreviations (*ACS*, *CPS*, *MTS*, *CPI*) consistently across sections, spelled out at first use in every
268
+ stand-alone part; after the first mention prefer plain names (*the household survey*). Spell out state names in text (*Fall River,
269
+ Massachusetts*); in a crowded table use *Nev., Pa.* (postal codes only with zip codes).
270
+ - **No Latin abbreviations in text:** *for example, that is, and others, and so forth, in itself, annually* — Not
271
+ "e.g.", "i.e.", "et al.", "etc.", "per se", "per annum", "vis-à-vis". *per capita, ad hoc, a priori, de facto, versus*
272
+ are not italicized.
273
+ - **Quotation marks** for a word or term referred to as itself, at first reference only, and not after *called*,
274
+ *known as*, *referred to as*. Sparingly for emphasis or jargon (rewriting is better).
275
+ - **Lists:** items in a sentence go in alphabetical order unless another logic (size, importance) applies. Bulleted
276
+ lists, sparingly: introduce with a complete sentence plus colon; items parallel, first word capitalized; no item longer
277
+ than about one-third of a column. Sentences end with periods; fragments end with commas (semicolons if any item has
278
+ internal commas), with *and*/*or* after the next-to-last item and a period on the last. Key-takeaway bullets may open
279
+ with a boldface sentence-case lead-in. Number a list only for order or later reference.
280
+
281
+ ## 5. Exhibits (tables and figures)
282
+
283
+ - **Titles** define the data shown (*Employment Rates of People Ages 25 to 54*). Message titles (*Foreign-Born Workers'
284
+ Share Has Grown*) are acceptable only if used consistently through the document. For subgroup comparisons, end the
285
+ title with a *by* phrase: *Share of Veterans Ages 22 to 54, by VA Disability Rating*. Leave years out of the title
286
+ when the axis or column heads show them, unless needed to tell exhibits apart. No two exhibits share a title. Either
287
+ always spell out a name in titles or always abbreviate it (and define it in a note).
288
+ - **Units line** under the title, sentence case: *Percent*, *Millions of people*, *2025 dollars*, *Percentage points*.
289
+ The unit is not the idea: Not "Percentage change"; OK unit *Percent* with *Annual Change in ...* in the title. On a
290
+ figure, the unit sits above the y-axis; a non-year x-axis unit goes below the x-axis. A different unit within a table
291
+ goes in parentheses in the row's first entry or the column head.
292
+ - **Stubs, column heads, labels, panel heads:** sentence case (capitalize only the first word; nothing in parentheses).
293
+ Totals rows, column heads, and panel heads in boldface. Supplemental rows at the bottom follow a boldface stub
294
+ *Addendum:* (formerly "Memorandum").
295
+ - **Captions:** each figure generally gets one, adding reasons or implications rather than restating the chart; numbers
296
+ in a caption should be visible in the figure.
297
+ - **Notes, in this order:**
298
+ 1. **Data source note.** *Data source: <Organization>.* for the organization's own data; *Data source: <Organization>,
299
+ using data from [sources, alphabetically].* when the analysis modified others' data (growth rates, tabulations,
300
+ fiscal-year totals, weighting, inflation adjustment — that is, most exhibits). When no organization is named: *Data source: Analyst calculations
301
+ using data from [sources].* *Data sources: Bureau of Labor Statistics; Census Bureau.* for unmodified data. Name
302
+ the survey or series when it helps, note revision dates for revised data, and say which source covers which part.
303
+ A data-and-methods appendix may be cited: *using data described in Appendix A*. End with the URL where the
304
+ exhibit's data are posted, if any. No abbreviations in source notes (*the staff of the Joint Committee on
305
+ Taxation*; *Bureau of Labor Statistics*, Not "BLS" at first mention).
306
+ 2. **General notes**, broadest first; in multipanel exhibits, in panel order.
307
+ 3. **Abbreviations note:** abbreviations alphabetically, then *n.a. = not applicable*, *N.A. = not available*, *n.e. =
308
+ not estimated*, then asterisk notations (*\* = between zero and 0.5 percent*). *GDP* needs no definition.
309
+ 4. **Footnotes** to specific cells or labels, with superscript lowercase letters ordered left to right, top to bottom.
310
+ - **Recessions** shaded in figures get the note *Shaded areas indicate recessions as dated by the NBER* (builder adds it).
311
+ - **Referring to a stub or label in text:** quote it as capitalized in the exhibit, with a singular verb (*"Other
312
+ sources" consists of...*), or describe it generically to avoid the quotation marks.
313
+ - Rounding note once at the front; table zeros per Section 2.
314
+
315
+ **Standard pattern for exhibits:**
316
+ - Label *Exhibit n.* (or *Figure n.*); number consecutively; appendix exhibits get their own sequence (*Figure A-1*).
317
+ - **Data source line:** name the original agency and the dataset or series, then any intermediary: *Data source:
318
+ Analyst calculations using data from the Bureau of Labor Statistics (Current Population Survey, series LNS14000000),
319
+ retrieved October 20, 2026.* For data reached through an aggregator, *... from the Bureau of Economic Analysis,
320
+ retrieved from FRED, Federal Reserve Bank of St. Louis*; for microdata, *... as provided by IPUMS USA*. With several
321
+ sources, list them alphabetically and say which covers which part. Or *Data source: <Organization>, using data from
322
+ …* when an organization is named. Give the retrieval date or vintage for data that are revised. The audit checks that
323
+ every source line names a source the report used.
324
+ - **General notes:** full sentences ending in periods, in this order: the measure and universe (*civilian employees
325
+ on board at the end of September*, *people ages 25 to 54*); definitions; period basis (*Years are federal fiscal
326
+ years, which run from October 1 to September 30.*); seasonal adjustment; weighting; dollar year and price index;
327
+ preliminary, projected or missing values (*Data for October 2025 were not collected.*); redaction or suppression;
328
+ sign conventions (*A positive value is a deficit.*); the vintage when not the latest; recession shading (the builder
329
+ adds the note).
330
+ - **Text callouts:** *see Exhibit 2*; each section opens with its key finding and the exhibit supports it.
331
+
332
+ ## 6. Footnotes and references
333
+
334
+ **Footnotes in text:** use them to cite an authority or give a brief explanation (or a long definition), and keep them
335
+ few — if most readers would ask the question, answer it in the text. Number consecutively, restarting in the summary,
336
+ each chapter, each appendix, and each box. Place the number at the end of the sentence, after the punctuation, one per
337
+ sentence (combine sources into one note); every footnote ends with a period. Give the full reference each time (no
338
+ short-form repeats); *ibid.* (not italicized) for a source identical to the preceding note. Multiple references:
339
+ reverse chronological order, separated by semicolons. Omit "the" before organizations, periodicals, and publishers in
340
+ citations. Use headline-style capitalization for titles but keep the source's own hyphenation (en dash for year ranges).
341
+
342
+ **Reference format:** Author, *Title*, extra information (Publisher, Date), pages, URL.
343
+ - Author: first and last names; more than three authors → *and others* (Not "et al."); an organization can be the
344
+ author.
345
+ - Titles: italics for books, reports, and journals; quotation marks and roman type for articles, web pages, and
346
+ datasets.
347
+ - Date in parentheses; a web page with no date gets *(accessed Month Day, Year)*.
348
+ - URL: drop "http://" when the address has "www."; link to a summary page rather than a PDF, and give a PDF's file size
349
+ if you must link to one (*(3 MB)*); DOI for journal articles; never a URL alone.
350
+ - Court cases in italics with italic *v.*, naming the court and year in text.
351
+ - Examples: *Bureau of Labor Statistics, "Foreign-Born Workers: Labor Force Characteristics—2023," news release
352
+ (May 2024), www.bls.gov/news.release/forbrn.nr0.htm.* — *Rose M. Kreider and Diana B. Elliott, America's Families and
353
+ Living Arrangements: 2007, Current Population Reports P20-561 (Census Bureau, September 2009), www.census.gov/...* —
354
+ *Kenneth A. Couch and Dana W. Placzek, "Earnings Losses of Displaced Workers Revisited," American Economic Review,
355
+ vol. 100, no. 1 (March 2010), pp. 572–589, https://doi.org/10.1257/aer.100.1.572.* — web page or data table:
356
+ *Organization, "Page Title" (date or accessed date), Table n, URL.*
357
+ - **Datasets and series** (data-table rule)**:** *Agency, "Dataset or Table Title" (dataset, accessed Month Day,
358
+ Year), Table n, URL.* Copy the citation the source asks for from `data/<id>/README.md` (each pack writes it, for
359
+ example a series citation with its ID, an extract's DOI and version, or a statement's table number). Required notices
360
+ (API terms such as "uses the ... API but is not endorsed or certified by ...", or a statement that the agency cannot
361
+ vouch for derived analyses) are added by the report builder from each source's policy; never drop them and never use
362
+ an agency's logo.
363
+
364
+ ## 7. Editor's checklist
365
+
366
+ 1. No "we"/"our"/"I"; the organization by name (full name at first reference in each stand-alone part) or the third
367
+ person (*this analysis*); *estimates that*; no "predicts"/"assumed" for the analysis's own estimates; no
368
+ contractions; no unrequested advice; no "reform"?
369
+ 2. Every technical term, rate, universe, mean/median, *real*, and abbreviation defined at first use — and again in each
370
+ stand-alone section?
371
+ 3. Zero–nine spelled out, 10+ numerals, same-category series consistent; no sentence starts with a numeral or a year?
372
+ 4. *percent* spelled out; *percentage points* for differences (never "of GDP"); *share* only for part of a whole; no
373
+ "times less"; no huge percentage changes?
374
+ 5. Ranges: en dash only before a noun; *from X to Y* for dates (no "between"); unit repeated only for a change over time;
375
+ years in full?
376
+ 6. Ages as *ages 25 to 54*, *age 65 or older*, in numerals; no "the elderly"?
377
+ 7. Calendar-year, rounding, retrieval-date and vintage notes at the front; dollar year and price index named (*in
378
+ 2025 dollars*); preliminary and projected values called so?
379
+ 8. Hyphens: *full-time/part-time/well-off* always; *low-income* only before a noun, after *families with low income* at
380
+ first use; none after *-ly*; *very* drops it?
381
+ 9. Word choices: *data are*, *dataset*, *compared with* (or *than*), *affect/effect*, *because* (not "since"/"as"),
382
+ *whereas/although* (not "while") for contrast, no *with* clauses, *that/which* commas, *fewer/less*, *due to* only
383
+ after a noun, *analytical*, *method*?
384
+ 10. Change verbs fit the measure: rates and wages *higher/lower, rise/fall*; shares *larger/smaller, grow/shrink*;
385
+ growth *faster/slower*?
386
+ 11. Race and ethnicity: *Black*, *White* capitalized and never nouns; categories alphabetical with the composite last;
387
+ scheme explained; *sex* for the survey variable?
388
+ 12. Pronouns: no "he or she"; singular *they* or a plural rewrite; organizations are *it*?
389
+ 13. Titles and headings in headline style (*Anti-Inflationary*); serial comma; first callouts as *see Exhibit n*?
390
+ 14. Every exhibit: number, title (with *by* for subgroups), units line, then notes in order — *Data source:* line (no
391
+ abbreviations, sources alphabetical), general notes (universe, definitions, weights, years), abbreviations,
392
+ lettered footnotes; stubs in sentence case?
393
+ 15. Table zeros as *0* or an asterisk with a narrow note; true minus in text and figures, hyphen in tables; decimals
394
+ consistent within each series?
395
+ 16. Footnotes: full references ending in periods, one per sentence, after the punctuation; URLs to summary pages; PDF
396
+ sizes noted?
397
+ 17. None of "e.g.", "i.e.", "etc.", "et al.", "utilize", "prior to", "regarding", "upon", "around" for approximately,
398
+ "appear to", "lion's share", "Americans", "and/or", "methodology", "data set", "Internet"?