नामकरणधर्मः। लेखनबाधाधर्मस्य (१७ जन) अनन्तरं अत्र नामकरणम्: नामकरणधर्मः स्थिरसंज्ञा पुनर्नाम सेतुकालः। नामकरणधर्मः।

English (minimizable)

After write fences (17 Jan), this post covers naming: stable IDs versus display names, slug rules, rename bridges and why cute renames without windows break clients.

पूर्ण-शीर्षकम् / Full title

नामकरणधर्मः: A Metrical Codification of Naming Dharma (with English glosses)

English · overview and topics (minimizable)

What this post is about

Names are contracts. Change the face if you must but keep the bone ID and a bridge of time.

Topics

  1. Why names
  2. Stable ID
  3. Display separate
  4. Slug rules
  5. Rename window
  6. Case and unicode
  7. Reserved words
  8. Deprecate loudly
  9. Not stringly typed everything
  10. Five limbs
  11. Close
  12. Seal

Sanskrit title

नामकरणधर्मः = dharma of naming.

English

Minimizable; Sanskrit-first.

परम्परा-सन्धिः / Series links
पूर्वं / Prior अत्र / Adds न पुनः / Does not repeat
लेखनबाधाधर्मः (१७ जन) who may write not what things are called
सेवाख्यातिधर्मः (३१ दिसं) discovery names cousin
अत्र naming conventions -
ग्राह्य-त्याज्य-विवेकः / Keep and avoid

ग्राह्यम् / Keep

१. immutable internal IDs: bone
२. mutable labels for humans: face
३. rename with dual-read window: bridge
४. document case folding: rules
५. deprecate with timeline: exit

त्याज्यम् / Avoid

  • Rename primary key in place
  • No dual-read period
  • Case-sensitive traps undocumented
  • Silent rename in prod
अध्याय-योजना / Chapter plan
प्रकरणम् विषयः छन्दः श्लोकाः
मङ्गलं बीजं च / Opening अनुष्टुभ्
मूलतत्त्वानि / Core अनुष्टुभ्
मुख्यविधिः / Method उपजाति
रक्षा · विधिः / Guards अनुष्टुभ्
विवेक · सीमा / Judgment अनुष्टुभ्
पूर्वसन्धिः / Series links उपजाति
उपसंहारः / Close अनुष्टुभ्
पारिभाषिक-कोशः / Glossary
Modern English संस्कृतम् Note
stable ID स्थिरसंज्ञा immutable key
display name प्रदर्शननाम human label
slug लघुपथनाम URL-safe name
rename window पुनर्नामसेतुः compat period
deprecate अवसादः scheduled removal

श्लोकः १ (अनुष्टुभ्)

नाम सन्धिः तस्माद् लघुपरिवर्तनेऽपि सेतुं ।
असेतौ ग्राहकाः पतन्ति सदा नित्यम् ॥१॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
नाम सन्धिः तस्माद् लघुपरिवर्तनेऽपि सेतुं । असेतौ ग्राहकाः पतन्ति सदा नित्यम् ॥१॥

Word-for-word

संस्कृतपदम् Word-for-word English
नाम नाम
सन्धिः सन्धिः
तस्माद् तस्माद्
लघुपरिवर्तनेऽपि लघुपरिवर्तनेऽपि
सेतुं सेतुं
असेतौ असेतौ
ग्राहकाः ग्राहकाः
पतन्ति पतन्ति
सदा सदा
नित्यम् नित्यम्

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
A name is a contract; even small renames need a bridge.

Context / topic
why

वृत्तमिति: ८-८-८-८।

श्लोकः २ (अनुष्टुभ्)

अस्थिसंज्ञां अचलां कुरु मुखनाम तु चलतु ।
अस्थिचले इतिहासो नश्यति नित्यम् ॥२॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
अस्थिसंज्ञां अचलां कुरु मुखनाम तु चलतु । अस्थिचले इतिहासो नश्यति नित्यम् ॥२॥

Word-for-word

संस्कृतपदम् Word-for-word English
अस्थिसंज्ञां अस्थिसंज्ञां
अचलां अचलां
कुरु कुरु
मुखनाम मुखनाम
तु तु
चलतु चलतु
अस्थिचले अस्थिचले
इतिहासो इतिहासो
नश्यति नश्यति
नित्यम् नित्यम्

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Keep bone IDs immutable; let display names move.

Context / topic
id

वृत्तमिति: ८-८-८-८।

श्लोकः ३ (उपजाति)

प्रदर्शनं पृथक् धरेत् एव ।
अन्वेषणे अस्थि गृह्ण सम्यक् ।
मुखे मा बन्धनम् सदा सम्यक् ।
एवं नामद्वयम् सदा सम्यक् ॥३॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
प्रदर्शनं पृथक् धरेत् एव । अन्वेषणे अस्थि गृह्ण सम्यक् । मुखे मा बन्धनम् सदा सम्यक् । एवं नामद्वयम् सदा सम्यक् ॥३॥

Word-for-word

संस्कृतपदम् Word-for-word English
प्रदर्शनं प्रदर्शनं
पृथक् पृथक्
धरेत् धरेत्
एव एव
अन्वेषणे अन्वेषणे
अस्थि अस्थि
गृह्ण गृह्ण
सम्यक् सम्यक्
मुखे मुखे
मा मा
बन्धनम् बन्धनम्
सदा सदा

Gloss table

पदम् अर्थः / sense
धर्मः dharma

English sense
Search and join on the bone not the pretty face.

Context / topic
face

वृत्तमिति: एकादशाक्षराः पादाः।

श्लोकः ४ (अनुष्टुभ्)

लघुपथनाम नियमैः बध्नीहि वर्णसङ्कोचं ।
अनियमेषु युद्धं नित्यम् सदा नित्यम् ॥४॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
लघुपथनाम नियमैः बध्नीहि वर्णसङ्कोचं । अनियमेषु युद्धं नित्यम् सदा नित्यम् ॥४॥

Word-for-word

संस्कृतपदम् Word-for-word English
लघुपथनाम लघुपथनाम
नियमैः नियमैः
बध्नीहि बध्नीहि
वर्णसङ्कोचं वर्णसङ्कोचं
अनियमेषु अनियमेषु
युद्धं युद्धं
नित्यम् नित्यम्
सदा सदा

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Slug rules written; undocumented case wars never end.

Context / topic
slug

वृत्तमिति: ८-८-८-८।

श्लोकः ५ (अनुष्टुभ्)

पुनर्नाम्नि द्विपठनकालं देहि मा सहसा छिन्दि ।
सहसाच्छेदे बाणः शून्ये सदा नित्यम् ॥५॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
पुनर्नाम्नि द्विपठनकालं देहि मा सहसा छिन्दि । सहसाच्छेदे बाणः शून्ये सदा नित्यम् ॥५॥

Word-for-word

संस्कृतपदम् Word-for-word English
पुनर्नाम्नि पुनर्नाम्नि
द्विपठनकालं द्विपठनकालं
देहि देहि
मा मा
सहसा सहसा
छिन्दि छिन्दि
सहसाच्छेदे सहसाच्छेदे
बाणः बाणः
शून्ये शून्ये
सदा सदा
नित्यम् नित्यम्

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Rename with dual-read window; hard cut aims into void.

Context / topic
window

वृत्तमिति: ८-८-८-८।

श्लोकः ६ (अनुष्टुभ्)

यूनिकोडवर्णनं नीतिं लिख मा आश्चर्ये ।
आश्चर्ये सीमापारनामानि भिद्यन्ते हि ॥६॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
यूनिकोडवर्णनं नीतिं लिख मा आश्चर्ये । आश्चर्ये सीमापारनामानि भिद्यन्ते हि ॥६॥

Word-for-word

संस्कृतपदम् Word-for-word English
यूनिकोडवर्णनं यूनिकोडवर्णनं
नीतिं नीतिं
लिख लिख
मा मा
आश्चर्ये आश्चर्ये
सीमापारनामानि सीमापारनामानि
भिद्यन्ते भिद्यन्ते
हि हि

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Unicode and case policy before surprise; borders split names otherwise.

Context / topic
unicode

वृत्तमिति: ८-८-८-८।

श्लोकः ७ (अनुष्टुभ्)

रक्षितशब्दान् जान प्रणालीयान् मा दास्य ।
रक्षिते दत्ते सन्धिर्भिद्यते हि नित्यम् ॥७॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
रक्षितशब्दान् जान प्रणालीयान् मा दास्य । रक्षिते दत्ते सन्धिर्भिद्यते हि नित्यम् ॥७॥

Word-for-word

संस्कृतपदम् Word-for-word English
रक्षितशब्दान् रक्षितशब्दान्
जान जान
प्रणालीयान् प्रणालीयान्
मा मा
दास्य दास्य
रक्षिते रक्षिते
दत्ते दत्ते
सन्धिर्भिद्यते सन्धिर्भिद्यते
हि हि
नित्यम् नित्यम्

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Know reserved words; giving them away breaks the platform contract.

Context / topic
reserved

वृत्तमिति: ८-८-८-८।

श्लोकः ८ (अनुष्टुभ्)

अवसादं कालेन घोषय मौनं मा हन्धि ।
मौनावसादे विश्वासो नश्यति नित्यम् ॥८॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
अवसादं कालेन घोषय मौनं मा हन्धि । मौनावसादे विश्वासो नश्यति नित्यम् ॥८॥

Word-for-word

संस्कृतपदम् Word-for-word English
अवसादं अवसादं
कालेन कालेन
घोषय घोषय
मौनं मौनं
मा मा
हन्धि हन्धि
मौनावसादे मौनावसादे
विश्वासो विश्वासो
नश्यति नश्यति
नित्यम् नित्यम्

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Deprecate on a timeline out loud; silent death kills trust.

Context / topic
deprecate

वृत्तमिति: ८-८-८-८।

श्लोकः ९ (अनुष्टुभ्)

न सर्वं सूत्रनाम्ना बध्नीहि पथि सदा ।
अस्थिसंज्ञा स्थाने तस्याः नित्यम् हि नित्यम् ॥९॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
न सर्वं सूत्रनाम्ना बध्नीहि पथि सदा । अस्थिसंज्ञा स्थाने तस्याः नित्यम् हि नित्यम् ॥९॥

Word-for-word

संस्कृतपदम् Word-for-word English
सर्वं सर्वं
सूत्रनाम्ना सूत्रनाम्ना
बध्नीहि बध्नीहि
पथि पथि
सदा सदा
अस्थिसंज्ञा अस्थिसंज्ञा
स्थाने स्थाने
तस्याः तस्याः
नित्यम् नित्यम्
हि हि

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Not everything is a stringly name; prefer stable IDs underneath.

Context / topic
not stringly

वृत्तमिति: ८-८-८-८।

श्लोकः १० (उपजाति)

अस्थि मुखं लघुपथम् एव ।
सेतुं वर्णं रक्षितम् हि सम्यक् ।
अवसादं सूत्रविवेकम् सदा ।
पञ्चाङ्गं नामकरण उच्यते ॥१०॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
अस्थि मुखं लघुपथम् एव । सेतुं वर्णं रक्षितम् हि सम्यक् । अवसादं सूत्रविवेकम् सदा । पञ्चाङ्गं नामकरण उच्यते ॥१०॥

Word-for-word

संस्कृतपदम् Word-for-word English
अस्थि अस्थि
मुखं मुखं
लघुपथम् लघुपथम्
एव एव
सेतुं सेतुं
वर्णं वर्णं
रक्षितम् रक्षितम्
हि हि
सम्यक् सम्यक्
अवसादं अवसादं
सूत्रविवेकम् सूत्रविवेकम्
सदा सदा

Gloss table

पदम् अर्थः / sense
धर्मः dharma

English sense
Five limbs of naming dharma.

Context / topic
five

वृत्तमिति: एकादशाक्षराः पादाः।

श्लोकः ११ (अनुष्टुभ्)

इति नामसारः सेतुसत्ययुक्तः सदा ।
मापितसंज्ञा कर्मयोग्या तन्त्रधर्मः स उच्यते ॥११॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
इति नामसारः सेतुसत्ययुक्तः सदा । मापितसंज्ञा कर्मयोग्या तन्त्रधर्मः स उच्यते ॥११॥

Word-for-word

संस्कृतपदम् Word-for-word English
इति इति
नामसारः नामसारः
सेतुसत्ययुक्तः सेतुसत्ययुक्तः
सदा सदा
मापितसंज्ञा मापितसंज्ञा
कर्मयोग्या कर्मयोग्या
तन्त्रधर्मः तन्त्रधर्मः
उच्यते उच्यते

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Closing: operable names under bridge law.

Context / topic
close

वृत्तमिति: ८-८-८-८।

श्लोकः १२ (अनुष्टुभ्)

अस्थि रक्ष मुखं पृथक् कुरु सेतुं देहि कालेन ।
सूत्रे मा सर्वं नामधर्मः स उच्यते पथि ॥१२॥
पदच्छेदः · Word-for-word · English (minimizable)

पदच्छेदः
अस्थि रक्ष मुखं पृथक् कुरु सेतुं देहि कालेन । सूत्रे मा सर्वं नामधर्मः स उच्यते पथि ॥१२॥

Word-for-word

संस्कृतपदम् Word-for-word English
अस्थि अस्थि
रक्ष रक्ष
मुखं मुखं
पृथक् पृथक्
कुरु कुरु
सेतुं सेतुं
देहि देहि
कालेन कालेन
सूत्रे सूत्रे
मा मा
सर्वं सर्वं
नामधर्मः नामधर्मः

Gloss table

पदम् अर्थः / sense
धर्मः dharma
मितम् measured

English sense
Bone stable, face free, bridge renames, deprecate loudly, IDs under strings.

Context / topic
seal

वृत्तमिति: ८-८-८-८।

श्लोकसूची / Verse index

१. अस्थि रक्ष
२. मुखं पृथक् कुरु
३. लघुपथं नियमय
४. सेतुं देहि
५. वर्णं लिख
६. रक्षितं जान
७. कालेन अवसादय
८. सूत्रे मा सर्वं
९. पञ्चाङ्गं स्मर
१०. सन्धिं रक्ष
११. सत्यं नामय
१२. धर्मं धारय

सन्दर्भाः / References
  1. API naming guides
  2. Compatible renames
  3. Prior: fence 17 Jan, discovery 31 Dec