Incorporated some edits from the defunct pull request below to make this section read a little more easily. Some particulars
* Instead of stating as good way, bad way, ugly way -> state as their technical name and put (the good way) bracketed after
* The first and third examples referred to "you" and the second referred to "Alice and Bob". All three now refer to "you"
* Each paragraph now describes the method with a one liner
* Some miscellaneous detail
https://github.com/lnbook/lnbook/pull/307
- open source: as adjective written with hyphen (according to Wiktionary)
- you --> your
- simplifications
- docker --> unless it is a command, I would uppercase it (see Wikipedia)
- more --> more than what? primarily
- node: repetitive
- above we use _..._ for product names, etc. --> changes +...+ to _..._
- one --> once
- commas: only put comma in front of _but_ whe followed by a complete sentence with noun
- simplifications
- etc
- simplifications
- commas
- "set up" is a verb, not a noun --> "setup"
- COLDCARDwallet --> They themselves on their website use predominantly "Coldcard Wallet". Their logo image does use uppercase, but they do not use uppercase in their text/manuals.
- a number is not expanding, a number is growing
- etc
- "a lot cheaper", "a lot faster" : quite undefined, this might mean different things to different readers
- I like "incantations" but it is slang. Also some foreigners might not know this word. --> then I decided to leave it in as is. Adds some special touch.
- simplifications
- "Specialized Hardware" --> sounds a bit misleading. The hardware is not special, it is off-the-shelf hardware configured to suit the needs of LN (not like mining hardware)
- I felt the "Cloud" section was too one-sided. Just the negative points were mentioned. we should be objective and also mention the upsides.
- Describe the situation fairly, let the user form an opinion
- we give free advertising to the big 3 (MS, G, AWS), let's also give advertising to at least one smaller player: added DigitalOcean
I'd like to also credit Gabriel Comtefor this contribution as his medium article helped me write this section on Zombie channels. Specifically the points on Zombie channels being a burden on the network, and losing your funds even if you have a channel.backup are taken from his article below.
https://medium.com/@gcomxx/get-rid-of-those-zombie-channels-1267d5a2a708
- "reading" --> "having read": since the reading was more than just a few minutes but most likely a couple of hours spread over a couple of days
- better "participant in" than "participant of"
- no comma in list of 2
- do use comma in list of 3+ (see PR # 340), Oxford comma for consistency
- 10 cents, hence 10 satoshis (different is : a 10 cent coin, a 20 dollar suit), but in an amount: use plural: one dollar and 32 cents. Here 10,000 satoshiS (s)
- "a bunch of", very colloquial, --> "several"
- Oxford comma in list of 3 or more
- "funny" --> "unusual"
- "could" --> "can", more encouraging
- "cheap long" and "expensive short" --> add comma, comma should be placed between two adjectives of equal rank
- "it's own" (incorrect) --> its (possessive)
- "explore and dig deeper" (one does not explore deeper) --> explore further and dig deeper
