mirror of
https://github.com/Gnucash/gnucash.git
synced 2024-11-26 02:40:43 -06:00
Update key-value policy.
git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@2734 57a11ea4-9604-0410-9ed3-97b8803252fd
This commit is contained in:
parent
a11ffa70df
commit
248e7f0740
@ -248,15 +248,26 @@ the use of keys and values. Please consult this document before planning
|
||||
any use of new keys.
|
||||
|
||||
@item
|
||||
Key strings should be in all lower case with the @code{'_'} character
|
||||
separating words. Example: @code{"bank_info"}
|
||||
Key strings should be in all lower case with the '_' character
|
||||
separating words. If possible, use only alphanumeric characters
|
||||
and '_'. Example: @code{"bank_info"}
|
||||
|
||||
@item
|
||||
Favor longer, descriptive key strings over short ones. Example:
|
||||
@code{"online_banking_info"} is better than @code{"onln_bnk"}.
|
||||
|
||||
@item
|
||||
Make use of the fact that frames can be stored in frames. If a group
|
||||
of keys are used for a related purpose, consider storing them together
|
||||
in a sub-frame.
|
||||
|
||||
@item
|
||||
Values should generally not be accessed directly through keys, but
|
||||
should rather be accessed through specific API calls.
|
||||
|
||||
@end itemize
|
||||
|
||||
|
||||
@node Sessions, Account Groups, Key-Value Pair Frames, Engine
|
||||
@section Sessions
|
||||
@tindex Session
|
||||
|
Loading…
Reference in New Issue
Block a user