-
Notifications
You must be signed in to change notification settings - Fork 0
Document ID
Leon Starr edited this page Jul 23, 2026
·
3 revisions
I picked up my document naming convention from Sally Shlaer herself and never stopped using it:
Organization name, system name possibly followed by subsystem or any other focusing qualifiers ending with td for technical document or tn for technical note or any other document type qualifier followed by a number.
Document ID : mint.elevator3.td.1
Documents are generally things that are source materials that are used to generate other artifacts like code. So they are typically maintained like code whereas notes are anything from a screenshot of a note scrawled on a whiteboard to a detailed study of some topic.
I often use bk referencing background docs sourced by other people or organizations.
Copyright 2023-2026 © Leon Starr under MIT Open Source License