From cd5493d56c1fedfc92ef88076ef44c353bafea11 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Thu, 30 Nov 2023 16:40:53 -1000 Subject: [PATCH] cleanups --- src/Cookbook.md | 24 +++++++++++++----------- src/Getting-started-FAQ.md | 21 ++++++--------------- src/index.md | 17 ++++++++++------- 3 files changed, 29 insertions(+), 33 deletions(-) diff --git a/src/Cookbook.md b/src/Cookbook.md index 43b49a7..970f172 100644 --- a/src/Cookbook.md +++ b/src/Cookbook.md @@ -1,11 +1,19 @@ % Cookbook -This is the Plain Text Accounting Cookbook page -(formerly the wiki home page, now a sort of site map for plaintextaccounting.org. +This is the Plain Text Accounting Cookbook, +a sort of site map for plaintextaccounting.org. If you don't see what you need, ask for it in the [[index#news-discussion|chat]] and we'll add it, or you can [add it yourself](https://github.com/plaintextaccounting/plaintextaccounting/blob/master/src/Cookbook.md). +### See also + +- [[index|plaintextaccounting.org home page]] +- [Beancount cookbook](https://beancount.github.io/docs/command_line_accounting_cookbook.html) +- [hledger cookbook](https://hledger.org/cookbook.html) +- [Ledger wiki](https://github.com/ledger/ledger/wiki) +- [Reddit: plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/new) + ### Getting started - [[index|Home]] - links to news, videos, articles, docs and software. @@ -14,7 +22,7 @@ If you don't see what you need, ask for it in the - [[Choosing accounts]] - [[Entering data]] - [[Don't Sink Your First Attempts at Plaintext Accounting]] h/ledger beginner syntax tips -- [Syntax Quick Reference for the Ledger-Likes](https://plaintextaccounting.org/quickref/) +- [[quickref/index|Syntax quick reference]] ### General usage @@ -50,13 +58,7 @@ If you don't see what you need, ask for it in the - [[Time tracking]] - [[Trip expenses]] -### Miscellaneous +### About this site -- [plaintextaccounting.org README](https://github.com/plaintextaccounting/plaintextaccounting#readme) - +- [[README|plaintextaccounting.org README]] (or [on github](https://github.com/plaintextaccounting/plaintextaccounting#readme)) -### See also - -- [Beancount cookbook](https://beancount.github.io/docs/command_line_accounting_cookbook.html) -- [hledger cookbook](https://hledger.org/cookbook.html) -- [Ledger wiki](https://github.com/ledger/ledger/wiki) diff --git a/src/Getting-started-FAQ.md b/src/Getting-started-FAQ.md index ff4e8e5..5c03281 100644 --- a/src/Getting-started-FAQ.md +++ b/src/Getting-started-FAQ.md @@ -1,19 +1,10 @@ % Getting started FAQ -### Ledger, hledger, beancount, etc. - which should I choose ? +### Ledger, hledger, Beancount, etc. - which should I choose ? -Here are some [PTA app comparisons](https://plaintextaccounting.org#pta-app-comparisons). -Also: +Here are some [PTA app comparisons](https://plaintextaccounting.org#pta-app-comparisons). See also: -- [SM opinions on hledger for new users](https://fosstodon.org/@ellane@pkm.social/110120845522951139) - (2023) -- [hledger and Ledger](https://hledger.org/ledger.html) & - [hledger and other software](https://hledger.org/cookbook.html#other-software) - (2023) -- [A Comparison of Beancount and Ledger](https://beancount.github.io/docs/a_comparison_of_beancount_and_ledger_hledger.html) - (2014) - -We all have opinions - ask for them in chat or search the reddit / mail lists / web. +SM (2022): We all have opinions - ask for them in chat or search the reddit / mail lists / web. Circa 2022 I hope it's fair to say, without my bias showing: - Ledger, hledger and Beancount are the big three apps, with many users. @@ -23,13 +14,13 @@ Circa 2022 I hope it's fair to say, without my bias showing: the most actively maintained, and the most user-friendly. - Beancount has the most features for investing and trading, and the most support (and need) for customisation, via Python. -- Ledger and hledger parse files flexibly and forgivingly by default, with strictness as an option. - Beancount's file format is more restricted and always strictly enforced. +- Ledger and hledger parse files flexibly and forgivingly by default, with optional strictness. + Beancount's file format is more restricted and always strict. - It's generally relatively easy to migrate data from one to another, eg using [data conversion tools](https://plaintextaccounting.org#data-importconversion) like ledger2beancount and beancount2ledger. ---Simon M. +SM on new user experience (2023): https://fosstodon.org/@simonmic/110120922501551538 ### How to organise files ? Should I split the journal into many files ? diff --git a/src/index.md b/src/index.md index 66adb05..368bce6 100644 --- a/src/index.md +++ b/src/index.md @@ -58,7 +58,8 @@ Page contents: - [Utilities](#utilities) - [API](#api) -See also:\ +See also: +\ **[[Newcomer FAQ]]** - [[Newcomer FAQ#what-is-this|What is this]] - [[Newcomer FAQ#objections-and-concerns|Objections and concerns]] @@ -92,7 +93,7 @@ See also:\ - [PTA apps' mail lists](#pta-apps) \ **Reddit** -- [/r/plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/) +- [/r/plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/new) \ **Hacker News** - [stories](https://hn.algolia.com/?query=plain%20text%20accounting&sort=byDate&prefix=false&page=0&dateRange=all&type=story) @@ -332,7 +333,9 @@ See also:\ ### PTA app comparisons -- [hledger: Cookbook > Other software](https://hledger.org/cookbook.html#other-software) 2014, 2019, 2022 +- [hledger and Ledger](https://hledger.org/ledger.html), + [hledger and Beancount](https://hledger.org/beancount.html), + [hledger and other software](https://hledger.org/cookbook.html#other-software) 2014, 2019, 2022, 2023.. - [Matthias Kauer: Command Line Accounting – A look at the various ledger ports](http://www.matthiaskauer.com/2015/08/command-line-accounting-a-look-at-the-various-ledger-ports/) 2015 - [beancount list: Another Ledger user's perspective](https://groups.google.com/d/msg/beancount/QV4qgpFbtJ8/9fSgMw-XGC8J) 2015 - [Beancount: A Comparison of Beancount and Ledger](https://docs.google.com/document/d/1dW2vIjaXVJAf9hr7GlZVe3fJOkM-MtlVjvCO1ZpNLmg) 2014 @@ -358,8 +361,8 @@ See also:\ - [Beancount Syntax Cheat Sheet](https://beancount.github.io/docs/beancount_cheat_sheet.html) - [Beginners corner: a basic hledger transaction](https://hledgerfan.com/beginners-corner-a-basic-hledger-transaction/) - [(Almost) everything you wanted to know about hledger transactions](https://hledgerfan.com/almost-everything-you-wanted-to-know-about-hledger-transactions/) -- [hledger > Journal cheatsheet](https://hledger.org/hledger.html#journal-cheatsheet) -- [hledger > CSV rules cheatsheet](https://hledger.org/hledger.html#csv-rules-cheatsheet) +- [hledger: Journal cheatsheet](https://hledger.org/hledger.html#journal-cheatsheet) +- [hledger: CSV rules cheatsheet](https://hledger.org/hledger.html#csv-rules-cheatsheet) ### Presentations @@ -381,8 +384,8 @@ See also:\ ### PTA apps -To do Plain Text Accounting, choose one of the apps below. -Generally it's possible to migrate data from one to another. +To do Plain Text Accounting, try one (or more) of the apps below. +Generally it's possible to migrate data between them.