From fac4c7d7ea32edf3037ce7940942fab93212ff4a Mon Sep 17 00:00:00 2001 From: Chad Whitacre Date: Thu, 28 Jan 2016 10:39:35 -0500 Subject: [PATCH 1/3] Specify explicating all transaction amounts --- README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d6b272b..c748e76 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,10 @@ Here are some style notes for the `dat` files: 1. Record debits first. - 1. Symmetry is nice. + 1. Symmetry is nice. + + 1. Explicate all transaction amounts (don't depend on ledger's implicit + transaction balancing). 1. Use comments! Especially for weird stuff. From ce0a29e55ecf4d84fa89402573a760a59dbae80d Mon Sep 17 00:00:00 2001 From: Chad Whitacre Date: Thu, 28 Jan 2016 10:39:52 -0500 Subject: [PATCH 2/3] Specify limitations on file changes --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index c748e76..71dd1b2 100644 --- a/README.md +++ b/README.md @@ -88,6 +88,24 @@ Here are some style notes for the `dat` files: 1. Use comments! Especially for weird stuff. +### Change Restrictions + +We start a PR for each month, named `YYYY-MM`. + +Inside of an open month, we may overwrite ledger transactions. Changes are git +commits and GitHub comments is sufficient. + +Outside of an open month, we must make correcting transactions in the current +month, rather than overwriting transactions in the old dat file. + +Inside of an open year, we can change account names, which affects all month +files for the year. + +Outside of an open year, we must archive accounts rather than renaming them. + +It's always okay to add comments to a file. + + ### Access Many accounting tasks require access to Gratipay's bank and payment processor From cd236350209513defbc505f15aa8c3350d833109 Mon Sep 17 00:00:00 2001 From: Chad Whitacre Date: Thu, 28 Jan 2016 11:05:06 -0500 Subject: [PATCH 3/3] Clean up Change Restrictions a bit --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 71dd1b2..bdd966c 100644 --- a/README.md +++ b/README.md @@ -90,16 +90,17 @@ Here are some style notes for the `dat` files: ### Change Restrictions -We start a PR for each month, named `YYYY-MM`. +We start a PR for each month, named `YYYY-MM`, and we close the month by +merging the PR. -Inside of an open month, we may overwrite ledger transactions. Changes are git -commits and GitHub comments is sufficient. +Inside of an open month, we should overwrite ledger transactions as needed. +Changes are tracked in git commits and GitHub comments. Outside of an open month, we must make correcting transactions in the current month, rather than overwriting transactions in the old dat file. -Inside of an open year, we can change account names, which affects all month -files for the year. +Inside of an open year, we may change account names (this affects all month +files for the year). Outside of an open year, we must archive accounts rather than renaming them.