This document describes the conventions adopted in Ledger for the relevant languages: English and C++.
This section applies to written communication in docs, code comments, commit messages, emails, etc.
The project and the resulting application are called “Ledger”. It is a proper name, hence it is not preceded by an article.
Do: Ledger synchronizes user data across devices
Don't: the Ledger synchronizes user data across devices
Don't: ledger synchronizes user data across devices
All of the data stored in Ledger on behalf of a user is sometimes referred to as this user's ledger. In that case “ledger” is a common name - not capitalized and preceded by an article.
Do: each user has a separate ledger
Don't: each user has separate Ledger
Ledger, like the rest of Fuchsia, follows Google C++ Style Guide. In a few cases not covered there, we choose a convention.
If there is a need to distinguish callback parameters of a method or a class, call them on_<event>.
Do: std::function<void(int)> on_done
Don't: std::function<void(int)> done_callback
