docs: finish the DECISION-to-CHOICE vocabulary outside rules.md (P13)

This commit is contained in:
swaits committed 2026-10-26 21:23:16 -06:00
1 parent 1855aa938e
commit f85b03f467
3 files changed
+6 -5

No files matched your search

+2 -1
View File
@@ -98,7 +98,8 @@ So the bar, for every agent, every change:
mechanics of double entry, the IRS (vendored verbatim, public domain) mechanics of double entry, the IRS (vendored verbatim, public domain)
for records, periods, 1099s, capitalization, partnerships, and payroll, for records, periods, 1099s, capitalization, partnerships, and payroll,
FASB's Codification (cited, never copied) for GAAP. A rule no authority FASB's Codification (cited, never copied) for GAAP. A rule no authority
states is marked CONVENTION or DECISION, with who decided and when. states is marked CONVENTION or CHOICE (bookspec's word for a
decision), with who decided and when.
Spec blocks in the code (```text GOAL/SOURCE/INVARIANTS/SCENARIOS) Spec blocks in the code (```text GOAL/SOURCE/INVARIANTS/SCENARIOS)
carry a `SOURCE:` line. Never write a spec from what the code happens carry a `SOURCE:` line. Never write a spec from what the code happens
to do, or from what you remember; find the document, or ask. to do, or from what you remember; find the document, or ask.
+3 -3
View File
@@ -18,18 +18,18 @@ layers differ in what they cover and in whether we may copy them:
| **FASB Accounting Standards Codification (ASC)** | Authoritative US GAAP: cash flows (ASC 230), revenue and principal vs agent (ASC 606), foreign currency (ASC 830), credit losses and aging (ASC 326), property and depreciation (ASC 360) | © Financial Accounting Foundation | Cited by paragraph with short quotes only (in `rules.md`; the paragraphs read, with where and when, in `sources/fasb-asc.md` and below) | | **FASB Accounting Standards Codification (ASC)** | Authoritative US GAAP: cash flows (ASC 230), revenue and principal vs agent (ASC 606), foreign currency (ASC 830), credit losses and aging (ASC 326), property and depreciation (ASC 360) | © Financial Accounting Foundation | Cited by paragraph with short quotes only (in `rules.md`; the paragraphs read, with where and when, in `sources/fasb-asc.md` and below) |
| **FASB Concepts Statement No. 8, Chapter 4 (2021)** | Definitions of the five elements (it replaced Concepts Statement 6) | © Financial Accounting Foundation; non-authoritative | Cited with short quotes only | | **FASB Concepts Statement No. 8, Chapter 4 (2021)** | Definitions of the five elements (it replaced Concepts Statement 6) | © Financial Accounting Foundation; non-authoritative | Cited with short quotes only |
| **Textbooks (OpenStax *Principles of Accounting, Vol. 1*)** | Conventions no standard states: normal balances, closing-entry mechanics, straight-line depreciation arithmetic | CC BY-NC-SA 4.0 (incompatible with this repo's license) | Cited with short quotes and attribution only | | **Textbooks (OpenStax *Principles of Accounting, Vol. 1*)** | Conventions no standard states: normal balances, closing-entry mechanics, straight-line depreciation arithmetic | CC BY-NC-SA 4.0 (incompatible with this repo's license) | Cited with short quotes and attribution only |
| **Convention or decision** | Where no authority speaks: aging bucket edges, cent rounding among members, closed-period locks | — | Stated as CONVENTION or DECISION, with who decided and when | | **Convention or decision** | Where no authority speaks: aging bucket edges, cent rounding among members, closed-period locks | — | Stated as CONVENTION or CHOICE, with who decided and when |
## How to read a SOURCE line ## How to read a SOURCE line
```text ```text
SOURCE: Pacioli ch. 36 (sources/pacioli-1494.md); IRS Pub. 583 (sources/irs-records.md) SOURCE: Pacioli ch. 36 (sources/pacioli-1494.md); IRS Pub. 583 (sources/irs-records.md)
SOURCE: ASC 830-20-30-1 (cited, rules.md B-3) SOURCE: ASC 830-20-30-1 (cited, rules.md B-3)
SOURCE: DECISION (the owner, 2026-10-13) SOURCE: CHOICE (the owner, 2026-10-13)
SOURCE: CONVENTION (QuickBooks aging); nearest authority ASC 326-20-55-38 (illustrative) SOURCE: CONVENTION (QuickBooks aging); nearest authority ASC 326-20-55-38 (illustrative)
``` ```
A rule whose only source is CONVENTION or DECISION is a candidate for a A rule whose only source is CONVENTION or CHOICE is a candidate for a
human to confirm or overturn; nothing else is. human to confirm or overturn; nothing else is.
## Rules added later never lock out older books ## Rules added later never lock out older books
+1 -1
View File
@@ -85,4 +85,4 @@ Searched 2026-10-13 (the three US articles above; Intuit's other regional editio
- an exhaustive list of accepted date formats, or how QBO disambiguates `1/2/2018`; - an exhaustive list of accepted date formats, or how QBO disambiguates `1/2/2018`;
- whether a header row is mandatory. - whether a header row is mandatory.
Rules wanderbooks applies on these points are CONVENTION or DECISION, not Intuit's. Rules wanderbooks applies on these points are CONVENTION or CHOICE, not Intuit's.