Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Arthashastra and Technical Writing

559 views

Published on

The Arthashastra is not only an academic tome on politics and governance. It also offers advice on technical writing.

Published in: Software
  • Login to see the comments

Arthashastra and Technical Writing

  1. 1. ARTHASHASTRA AND TECHNICALWRITING STC India annual conference, 2017 Anindita Basu
  2. 2. anindita_basu Agenda
  3. 3. anindita_basu ■ Why is documentation important ■ Who is a good writer ■ What are the duties of a writer ■ How should a document be composed ■ What are the characteristics of good writing ■ What are the characteristics of bad writing
  4. 4. WHY IS DOCUMENTATION IMPORTANT
  5. 5. anindita_basu शासन-प्रधाना हि राजानः । तन्-मूलत्वात्संधध-ववग्रिय ः ।।
  6. 6. anindita_basu शासन-प्रधाना हि राजानः । तन्-मूलत्वात्संधध-ववग्रिय ः ।। The basis of wars and treaties
  7. 7. WHO IS A GOOD WRITER
  8. 8. anindita_basu तस्मादमात्य-सम्पदाउपेतः सवव-समयववदाशु-ग्रन्थश्चारु-अक्षर लेखन-वाचन-समथो लेखकः स्यात् ।।
  9. 9. anindita_basu तस्मादमात्य-सम्पदाउपेतः सवव-समयववदाशु-ग्रन्थश्चारु-अक्षर लेखन-वाचन-समथो लेखकः स्यात् ।। 1 2 3 4 5 1. Fit to be a counsellor 2. Knows all conventions 3. Reads well 4. Writes well 5. Speaks well
  10. 10. WHAT ARETHE DUTIES OF AWRITER
  11. 11. anindita_basu स अव्यग्र-मना राज्ञः संदेशं श्रुत्वा ननश्श्चत-अथं लेखं ववदध्यात्देश-ऐश्वयव-वंश-नामधेय-उपचारं ईश्वरस्य । देश-नामधेय-उपचारं अनीश्वरस्य ।।
  12. 12. anindita_basu स अव्यग्र-मना राज्ञः संदेशं श्रुत्वा ननश्श्चत-अथं लेखं ववदध्यात्देश-ऐश्वयव-वंश-नामधेय-उपचारं ईश्वरस्य । देश-नामधेय-उपचारं अनीश्वरस्य ।। 1 2 3 1. Listens carefully to the king 2. Thinks the matter out carefully, and puts it into writing 3. Tailors the writing to suit nobility or commoners 3
  13. 13. HOW SHOULD A DOCUMENT BE COMPOSED
  14. 14. anindita_basu जानतं कु लं स्थान-वयः-श्रुतानन कमव-ऋद्धध-शीलान्यथ देश-कालौ । यौन-अनुबन्धं च समीक्ष्य काये लेखं ववदध्यात्पुरुष-अनुरूपं ।।
  15. 15. anindita_basu जानतं कु लं स्थान-वयः-श्रुतानन कमव-ऋद्धध-शीलान्यथ देश-कालौ । यौन-अनुबन्धं च समीक्ष्य काये लेखं ववदध्यात्पुरुष-अनुरूपं ।। Of the same level as the person being written to
  16. 16. WHAT ARETHE CHARACTERISTICS OF GOODWRITING
  17. 17. anindita_basu ■ अथव-क्रमः सम्बन्धः पररपूर्वता माधुयं औदायं स्पष्टत्वं इनत लेख-सम्पत् ।। ■ तत्र यथावदनुपूवव-क्रक्रया प्रधानस्याथवस्य पूवं अभिननवेश इत्यथव-क्रमः ।। ■ प्रस्तुतस्याथवस्यानुपर धादुत्तरस्य ववधानं आ-समाप्तेररनत सम्बन्धः ।। ■ अथव-पद-अक्षरार्ां अन्यून-अनतररक्तता िेतु-उदािरर्-दृष्टान्तैरथव-उपवर्वनाअश्रान्त-पदताइनत पररपूर्वता ।। ■ सुख-उपनीत-चारु-अथव-शब्द-अभिधानं माधुयं ।। ■ अग्राम्य-शब्द-अभिधानं औदायं ।। ■ प्रतीत-शब्द-प्रय गः स्पष्टत्वं इनत ।।
  18. 18. anindita_basu अथव-क्रमः सम्बन्धः पररपूर्वता माधुयं औदायं स्पष्टत्वं इनत लेख-सम्पत् ।।
  19. 19. anindita_basu अथव-क्रमः सम्बन्धः पररपूर्वता माधुयं औदायं स्पष्टत्वं इनत लेख-सम्पत् ।। 1 2 3 4 5 6 1. Well-arranged 2. Relevant 3. Complete 4. Pleasant 5. Excellent 6. Clear
  20. 20. anindita_basu तत्र यथावदनुपूवव-क्रक्रया प्रधानस्याथवस्य पूवं अभिननवेश इत्यथव-क्रमः ।।
  21. 21. anindita_basu तत्र यथावदनुपूवव-क्रक्रया प्रधानस्याथवस्य पूवं अभिननवेश इत्यथव-क्रमः ।। Matter is arranged in the order of importance
  22. 22. anindita_basu प्रस्तुतस्याथवस्यानुपर धादुत्तरस्य ववधानं आ-समाप्तेररनत सम्बन्धः ।।
  23. 23. anindita_basu प्रस्तुतस्याथवस्यानुपर धादुत्तरस्य ववधानं आ-समाप्तेररनत सम्बन्धः ।। Things that are mentioned later do not contradict those mentioned earlier
  24. 24. anindita_basu अथव-पद-अक्षरार्ां अन्यून-अनतररक्तता िेतु-उदािरर्-दृष्टान्तैरथव-उपवर्वनाअश्रान्त-पदताइनत पररपूर्वता ।।
  25. 25. anindita_basu अथव-पद-अक्षरार्ां अन्यून-अनतररक्तता िेतु-उदािरर्-दृष्टान्तैरथव-उपवर्वनाअश्रान्त-पदताइनत पररपूर्वता ।। 1 2 3 1. Neither deficient nor redundant 2. Has reasons, examples, and illustrations 3. Uses strong action words
  26. 26. anindita_basu सुख-उपनीत-चारु-अथव-शब्द-अभिधानं माधुयं ।।
  27. 27. anindita_basu सुख-उपनीत-चारु-अथव-शब्द-अभिधानं माधुयं ।। Matter is fluidly described
  28. 28. anindita_basu अग्राम्य-शब्द-अभिधानं औदायं ।।
  29. 29. anindita_basu अग्राम्य-शब्द-अभिधानं औदायं ।। Colloquial words are not used
  30. 30. anindita_basu प्रतीत-शब्द-प्रय गः स्पष्टत्वं इनत ।।
  31. 31. anindita_basu प्रतीत-शब्द-प्रय गः स्पष्टत्वं इनत ।। Easily understood words are used
  32. 32. WHAT ARETHE CHARACTERISTICS OF BADWRITING
  33. 33. anindita_basu ■ अकाश्न्तव्यावघातः पुनर्-उक्तं अपशब्दः सम्प्लव इनत लेख-द षः ।। ■ तत्र काल-पत्त्रकं अचारु-ववषं अववराग-अक्षरत्वं अकाश्न्तः ।। ■ पूवेर् पश्श्चमस्यानुपपवत्तव्यावघातः ।। ■ उक्तस्याववशेषेर् द्ववतीयं उच्चारर्ं पुनर्-उक्तं ।। ■ भलङ्ग-वचन-काल-कारकार्ां अन्यथा-प्रय ग अपशब्दः ।। ■ अवगे वगव-करर्ं चावगव-क्रक्रया गुर्-ववपयावसः सम्प्लवः इनत ।।
  34. 34. anindita_basu अकाश्न्तव्यावघातः पुनर्-उक्तं अपशब्दः सम्प्लव इनत लेख-द षः ।।
  35. 35. anindita_basu अकाश्न्तव्यावघातः पुनर्-उक्तं अपशब्दः सम्प्लव इनत लेख-द षः ।। 1 2 3 4 5 1. Clumsiness 2. Contradiction 3. Repetition 4. Bad grammar 5. Bad arrangement
  36. 36. anindita_basu तत्र काल-पत्त्रकं अचारु-ववषं अववराग-अक्षरत्वं अकाश्न्तः ।।
  37. 37. anindita_basu तत्र काल-पत्त्रकं अचारु-ववषं अववराग-अक्षरत्वं अकाश्न्तः ।। 1 2 1. Black and ugly leaf 2. Uneven and colourless writing
  38. 38. anindita_basu पूवेर् पश्श्चमस्यानुपपवत्तव्यावघातः ।।
  39. 39. anindita_basu पूवेर् पश्श्चमस्यानुपपवत्तव्यावघातः ।। What was stated earlier is in contradiction with what is being said later
  40. 40. anindita_basu उक्तस्याववशेषेर् द्ववतीयं उच्चारर्ं पुनर्-उक्तं ।।
  41. 41. anindita_basu उक्तस्याववशेषेर् द्ववतीयं उच्चारर्ं पुनर्-उक्तं ।। Stating for a second time that which has been said earlier
  42. 42. anindita_basu भलङ्ग-वचन-काल-कारकार्ां अन्यथा-प्रय ग अपशब्दः ।।
  43. 43. anindita_basu भलङ्ग-वचन-काल-कारकार्ां अन्यथा-प्रय ग अपशब्दः ।। 1 2 3 4 1. Wrong gender 2. Wrong number 3. Wrong tense 4. Wrong case
  44. 44. anindita_basu अवगे वगव-करर्ं चावगव-क्रक्रया गुर्-ववपयावसः सम्प्लवः इनत ।।
  45. 45. anindita_basu अवगे वगव-करर्ं चावगव-क्रक्रया गुर्-ववपयावसः सम्प्लवः इनत ।। 1 2 1. Dividing into paragraphs in wrong places 2. Not giving a para break where needed
  46. 46. anindita_basu
  47. 47. anindita_basu Further reading ■ Sanskrit text: कौहटल्यस्य अथवशास्त्रम ् (https://sa.wikisource.org/s/6ge) ■ English text: Kautilya's Arthashastra (http://www.columbia.edu/itc/mealac/pritchett/00litlinks/kautilya/index.html)
  48. 48. anindita_basu Still more reading Developing QualityTechnical Information: A Handbook forWriters and Editors (available on amazon.in)
  49. 49. THANKYOU
  50. 50. BACKUP
  51. 51. WHAT ISTHE PUNISHMENT FOR BAD WRITING
  52. 52. anindita_basu च रं पारदाररकं वा म क्षयत राज-शासनं ऊनं अनतररक्तं वा भलखतः कन्यां दासीं वा सहिरण्यं अपरितः कू ट-व्यविाररर् ववमांस-ववक्रनयर्श्च वाम-िस्त-द्वव-पाद-वध । नव-शत वा दण्डः ।।
  53. 53. anindita_basu च रं पारदाररकं वा म क्षयत राज-शासनं ऊनं अनतररक्तं वा भलखतः कन्यां दासीं वा सहिरण्यं अपरितः कू ट-व्यविाररर् ववमांस-ववक्रनयर्श्च वाम-िस्त-द्वव-पाद-वध । नव-शत वा दण्डः ।। 1. The left hand and two feet cut off 2. Fine of 900 panas 1 2
  54. 54. DQTI
  55. 55. anindita_basu ■ Easy to use – Task orientation – Accuracy – Completeness ■ Easy to understand – Clarity – Concreteness – Style ■ Easy to find – Organisation – Retrievability – Visual effectiveness

×