mirror of
https://github.com/Gnucash/gnucash.git
synced 2025-02-25 18:55:30 -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.
|
any use of new keys.
|
||||||
|
|
||||||
@item
|
@item
|
||||||
Key strings should be in all lower case with the @code{'_'} character
|
Key strings should be in all lower case with the '_' character
|
||||||
separating words. Example: @code{"bank_info"}
|
separating words. If possible, use only alphanumeric characters
|
||||||
|
and '_'. Example: @code{"bank_info"}
|
||||||
|
|
||||||
@item
|
@item
|
||||||
Favor longer, descriptive key strings over short ones. Example:
|
Favor longer, descriptive key strings over short ones. Example:
|
||||||
@code{"online_banking_info"} is better than @code{"onln_bnk"}.
|
@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
|
@end itemize
|
||||||
|
|
||||||
|
|
||||||
@node Sessions, Account Groups, Key-Value Pair Frames, Engine
|
@node Sessions, Account Groups, Key-Value Pair Frames, Engine
|
||||||
@section Sessions
|
@section Sessions
|
||||||
@tindex Session
|
@tindex Session
|
||||||
|
Loading…
Reference in New Issue
Block a user