ഡോക്യുമെന്റേഷൻ

വിക്കിപീഡിയ, ഒരു സ്വതന്ത്ര വിജ്ഞാനകോശം.
Jump to navigation Jump to search
The multi-volume programmer's manual to a 1975 operating system called CB UNIX

പേപ്പർ, അല്ലെങ്കിൽ ഓൺ‌ലൈൻ, അല്ലെങ്കിൽ ഓഡിയോ ടേപ്പ് അല്ലെങ്കിൽ സിഡികൾ പോലുള്ള ഡിജിറ്റൽ അല്ലെങ്കിൽ അനലോഗ് മീഡിയയിൽ നൽകിയിരിക്കുന്ന ഒരു കൂട്ടം പ്രമാണങ്ങളാണ് ഡോക്യുമെന്റേഷൻ. ഉപയോക്തൃ ഗൈഡുകൾ, ധവളപത്രങ്ങൾ, ഓൺ-ലൈൻ സഹായം, ദ്രുത-റഫറൻസ് ഗൈഡുകൾ എന്നിവ ഉദാഹരണങ്ങളാണ്. പേപ്പർ (ഹാർഡ്-കോപ്പി) ഡോക്യുമെന്റേഷൻ കാണുന്നത് വളരെ കുറവാണ്. വെബ്‌സൈറ്റുകൾ, സോഫ്റ്റ്വെയർ ഉൽപ്പന്നങ്ങൾ, മറ്റ് ഓൺ‌ലൈൻ അപ്ലിക്കേഷനുകൾ എന്നിവയിലൂടെ ഡോക്യുമെന്റേഷൻ വിതരണം ചെയ്യുന്നു.

ഈ രംഗത്ത് വിദ്യാഭ്യാസം നേടിയ പ്രൊഫഷണലുകളെ ഡോക്യുമെന്റലിസ്റ്റുകൾ എന്ന് വിളിക്കുന്നു. ഈ ഫീൽഡ് 1968 ൽ അതിന്റെ പേര് ഇൻഫർമേഷൻ സയൻസ് എന്ന് മാറ്റി, പക്ഷേ ഡോക്യുമെന്റേഷൻ എന്ന പദത്തിന്റെ ചില ഉപയോഗങ്ങൾ ഇപ്പോഴും നിലവിലുണ്ട്, കൂടാതെ ഡോക്യുമെന്റേഷൻ എന്ന പദം പഠനമേഖലയായി വീണ്ടും അവതരിപ്പിക്കാനുള്ള ശ്രമങ്ങൾ നടക്കുന്നു.

ഡോക്യുമെന്റേഷൻ നിർമ്മിക്കുന്നതിനുള്ള തത്വങ്ങൾ[തിരുത്തുക]

ബന്ധപ്പെട്ട ഐ‌എസ്ഒ മാനദണ്ഡങ്ങൾ‌ പൊതുവായി എളുപ്പത്തിൽ‌ ലഭ്യമല്ലെങ്കിലും, ഈ വിഷയത്തിനായുള്ള മറ്റ് ഉറവിടങ്ങളിൽ‌ നിന്നുള്ള ഒരു ഗൈഡ് ഈ ഉദ്ദേശ്യത്തെ സഹായിക്കുന്നു. [1], [2],.[3]ഉപയോഗിച്ച പദങ്ങൾ, നടപടിക്രമങ്ങളുടെ നമ്പറിംഗ്, വാക്യങ്ങളുടെ ദൈർഘ്യം മുതലായവയെക്കുറിച്ച് ഡോക്യുമെന്റ് റൈറ്റിംഗിന്റെ നിരവധി തത്ത്വങ്ങൾ ഡേവിഡ് ബെർ‌ഗെർ നൽകിയിട്ടുണ്ട്.[4]

മാർഗ്ഗനിർദ്ദേശങ്ങൾ[തിരുത്തുക]

ഓരോ നിർദ്ദിഷ്ട ഫീൽഡും തരവും കൈകാര്യം ചെയ്യുന്ന വഴികാട്ടികളുടെ ഒരു പട്ടിക ചുവടെ ചേർക്കുന്നു:

നടപടിക്രമങ്ങളും സാങ്കേതികതകളും[തിരുത്തുക]

ഡോക്യുമെന്റേഷന്റെ നടപടിക്രമങ്ങൾ ഒരു മേഖലയിൽ നിന്ന് അല്ലെങ്കിൽ ഒരു തരത്തിൽ നിന്ന് മറ്റൊന്നിലേക്ക് വ്യത്യാസപ്പെടുന്നു. പൊതുവേ, ഡോക്യുമെന്റ് ഡ്രാഫ്റ്റിംഗ്, ഫോർമാറ്റിംഗ്, സമർപ്പിക്കൽ, അവലോകനം, അംഗീകാരം, വിതരണം, റീപോസ്റ്റിംഗ്, ട്രാക്കിംഗ് തുടങ്ങിയവ ഇതിൽ ഉൾപ്പെടാം. കൂടാതെ ഒരു കാര്യനിർവ്വഹണ ഉദ്യമത്തിലെ ബന്ധപ്പെട്ട സ്റ്റാൻഡേർഡ് ഓപ്പറേറ്റിങ് നടപടിക്രമം (SOPs) ഒന്നിച്ചുകൂട്ടുന്നു. തിരുത്തൽ നടത്തിയ ഉള്ളടക്കം സൃഷ്ടിക്കുന്നതും ഇതിൽ ഉൾപ്പെടാം. ഡോക്യുമെന്റേഷൻ വായിക്കാനും മനസിലാക്കാനും എളുപ്പമായിരിക്കണം. ഇത് ദൈർഘ്യമേറിയതും വളരെ മോശമായതുമാണെങ്കിൽ, അത് തെറ്റിദ്ധരിക്കപ്പെടുകയോ അവഗണിക്കുകയോ ചെയ്യാം. വ്യക്തവും ഹ്രസ്വവും പരിചിതവുമായ വാക്കുകൾ ഒരു വാക്യത്തിലേക്ക് പരമാവധി 15 വാക്കുകൾ വരെ ഉപയോഗിക്കണം. ലിംഗ ഹൈപ്പർ ന്യൂട്രൽ പദം മാത്രം ഉപയോഗിക്കുകയും സാംസ്കാരിക പക്ഷപാതം ഒഴിവാക്കുകയും വേണം. അവ നടപ്പാക്കുമ്പോൾ നടപടിക്രമങ്ങൾ അക്കമിട്ട് നിലനിർത്തണം.[11], [12], [13],.[14]

ഡോക്യുമെന്റേഷൻ നിർമ്മിക്കുന്നു[തിരുത്തുക]

സാങ്കേതിക എഴുത്തുകാരും കോർപ്പറേറ്റ് ആശയവിനിമയക്കാരും പ്രൊഫഷണലുകളാണ്, അവരുടെ പ്രവർത്തനമേഖലയും ജോലിയും ഡോക്യുമെന്റേഷൻ നിർമ്മാണമാണ്. സാങ്കേതിക എഴുത്തുകാർക്ക് വിഷയത്തിലും ഉള്ളടക്കമെഴുതുന്നതിലും കൈകാര്യം ചെയ്യുന്നതിലും ഒരു പശ്ചാത്തലമുണ്ട് (ഇൻഫർമേഷൻ ആർക്കിടെക്ചർ). സാങ്കേതിക എഴുത്തുകാർ സാധാരണയായി എഞ്ചിനീയർമാർ, സാങ്കേതിക വിദഗ്ധർ, മെഡിക്കൽ പ്രൊഫഷണലുകൾ, അല്ലെങ്കിൽ മറ്റ് തരത്തിലുള്ള ഉപഭോക്താക്കൾ എന്നിവരെ പോലുള്ള വിഷയവിദഗ്ദ്ധരുമായി (എസ്എംഇ) സഹകരിക്കുകയും ഉപയോക്താവിന്റെ ആവശ്യങ്ങൾ നിറവേറ്റുന്ന ഉള്ളടക്കം (ഡോക്യുമെന്റേഷൻ) നിർവചിക്കുകയും സൃഷ്ടിക്കുകയും ചെയ്യുന്നു. സംഘടിതമായ അല്ലെങ്കിൽ ഏകീകൃതമായ ആശയവിനിമയങ്ങളിൽ മിക്ക കമ്പനികൾക്കും ആവശ്യമായ മറ്റ് തരത്തിലുള്ള രേഖാമൂലമുള്ള ഡോക്യുമെന്റേഷൻ കാണപ്പെടുന്നു.

പ്രത്യേക ഡോക്യുമെന്റേഷൻ[തിരുത്തുക]

  • മാർക്കറ്റിംഗ് കമ്മ്യൂണിക്കേഷൻസ് (MarCom): വിവിധതരം അച്ചടി, ഇലക്‌ട്രോണിക്, സോഷ്യൽ മീഡിയകളിലൂടെ കമ്പനിയുടെ മൂല്യനിർണ്ണയം അറിയിക്കാൻ മാർക്കോം എഴുത്തുകാർ ശ്രമിക്കുന്നു. സംഘടിത രചനയുടെ ഈ മേഖല പലപ്പോഴും നിർദ്ദേശങ്ങളോട് പ്രതികരിക്കുന്നതിൽ വ്യാപൃതരാണ്.
  • ടെക്നിക്കൽ കമ്മ്യൂണിക്കേഷൻ (TechCom): സാങ്കേതിക എഴുത്തുകാർ ഒരു കമ്പനിയുടെ ഉൽപ്പന്നമോ സേവനമോ രേഖപ്പെടുത്തുന്നു. സാങ്കേതിക പ്രസിദ്ധീകരണത്തിൽ ഉപയോക്തൃ ഗൈഡുകൾ, ഇൻസ്റ്റാളേഷൻ, കോൺഫിഗറേഷൻ മാനുവലുകൾ, ട്രബിൾഷൂട്ടിംഗ് / റിപ്പയർ / മാറ്റിസ്ഥാപിക്കൽ നടപടിക്രമങ്ങൾ എന്നിവ ഉൾപ്പെടുന്നു..
  • നിയമപരമായ എഴുത്ത്: സ്വകാര്യ പ്രാക്ടീസിൽ ഏർപ്പെടാവുന്ന അല്ലെങ്കിൽ കോർപ്പറേറ്റ് കൗൺസിലായി നിലനിർത്താൻ കഴിയുന്ന അഭിഭാഷകരോ പാരലീഗലുകളോ ആണ് ഇത്തരം ഡോക്യുമെന്റേഷൻ പലപ്പോഴും തയ്യാറാക്കുന്നത്.
  • ആജ്ഞാനുവർത്തിത്വം ഡോക്യുമെന്റേഷൻ : സുരക്ഷാ അംഗീകാരം, നികുതി ഏർപ്പെടുത്തൽ, ധനസഹായം, സാങ്കേതിക അംഗീകാരം മുതലായവ പോലുള്ള ഏതെങ്കിലും കാര്യനിർവ്വഹണ ആജ്ഞാനുവർത്തിത്വ ആവശ്യങ്ങൾക്കായി ഈ തരത്തിലുള്ള ഡോക്യുമെന്റേഷനുവേണ്ടി സ്റ്റാൻഡേർഡ് ഓപ്പറേറ്റിംഗ് നടപടിക്രമങ്ങൾ (എസ്ഒപി) ക്രമീകരിക്കുന്നു.

ഇൻഡെക്സിംഗ്[തിരുത്തുക]

കമ്പ്യൂട്ടർ സയൻസിലെ ഡോക്യുമെന്റേഷൻ[തിരുത്തുക]

ഇനിപ്പറയുന്നവ സാധാരണ സോഫ്റ്റ്വെയർ ഡോക്യുമെന്റേഷൻ തരങ്ങളാണ്

സാധാരണ ഹാർഡ്‌വെയർ, സേവന ഡോക്യുമെന്റേഷൻ തരങ്ങൾ ഇനിപ്പറയുന്നവയാണ്.

  • നെറ്റ്‌വർക്ക് ഡയഗ്രമുകൾ
  • നെറ്റ്‌വർക്ക് ചിത്രങ്ങൾ
  • ഐടി സിസ്റ്റങ്ങൾക്കായുള്ള ഡാറ്റാഷീറ്റ് (സെർവർ, സ്വിച്ച്, ഉദാ.)
  • സേവന കാറ്റലോഗും സേവന പോർട്ട്‌ഫോളിയോയും (ITIL)

ഡോക്യുമെന്റേഷനിൽ സാധ്യതാ റിപ്പോർട്ട്, സാങ്കേതിക ഡോക്യുമെന്റേഷൻ, പ്രവർത്തന ഡോക്യുമെന്റേഷൻ, ലോഗ് ബുക്ക് മുതലായവ ഉൾപ്പെടുന്നു.

സോഫ്റ്റ്വെയർ ഡോക്യുമെന്റ് ചെയ്യുന്നതിനുള്ള ഉപകരണങ്ങൾ[തിരുത്തുക]

ഡോക്യുമെന്റേഷൻ സൃഷ്ടിക്കാൻ നിരവധി തരം സോഫ്റ്റ്വെയറുകളും ആപ്ലിക്കേഷനുകളും ഉപയോഗിക്കുന്നു.

സോഫ്റ്റ്വെയർ ഡോക്യുമെന്റേഷൻ ഫോൾഡർ (എസ്ഡിഎഫ്)

സിമുലേഷൻ വ്യവസായത്തിലെ സോഫ്റ്റ്വെയർ എഞ്ചിനീയർമാർ എഴുതിയ ഒരു സാധാരണ തരം സോഫ്റ്റ്വെയർ പ്രമാണം എസ്ഡിഎഫ് ആണ്. ഒരു സിമുലേറ്ററിനായി സോഫ്റ്റ്വെയർ വികസിപ്പിക്കുമ്പോൾ, പൂർണ്ണ ചലന നിയന്ത്രണ സംവിധാനങ്ങളുള്ള ഏവിയോണിക്സ് ഉപകരണങ്ങൾ മുതൽ 3 ഡി ടെറൈൻ ഡാറ്റാബേസുകൾ വരെയുള്ള എഞ്ചിനീയർ പ്രോജക്റ്റിന്റെയോ മൊഡ്യൂളിന്റെയോ വികസനം വിശദീകരിക്കുന്ന ഒരു നോട്ട്ബുക്ക് സൂക്ഷിക്കുന്നു. പ്രമാണം ഒരു വിക്കി പേജ്, എം‌എസ് വേഡ് ഡോക്യുമെന്റ് അല്ലെങ്കിൽ മറ്റ് പരിസ്ഥിതിയും ആകാം. സോഫ്റ്റ്‌വെയറിന്റെ ആശയവിനിമയ ഇന്റർഫേസ് വിശദീകരിക്കുന്ന ഒരു ഇന്റർഫേസ് വിഭാഗത്തിന്റെ ആവശ്യകതകൾ അവയിൽ അടങ്ങിയിരിക്കണം. ആശയത്തിന്റെ തെളിവ് വിശദീകരിക്കുന്നതിന് പലപ്പോഴും ഒരു കുറിപ്പുകൾ വിഭാഗം ഉപയോഗിക്കുന്നു. തുടർന്ന് പിശകുകളും മെച്ചപ്പെടുത്തലുകളും അടയാളപ്പെടുത്തുന്നു. അവസാനമായി, സോഫ്റ്റ്വെയർ എങ്ങനെ പരീക്ഷിച്ചുവെന്ന് രേഖപ്പെടുത്തുന്നതിനുള്ള ഒരു പരിശോധന വിഭാഗവും ഉൾപ്പെടുന്നു. ഇത് ക്ലയന്റിന്റെ ആവശ്യകതകളുമായി പൊരുത്തപ്പെടുന്നു. സോഫ്റ്റ്വെയർ എങ്ങനെ രൂപകൽപ്പന ചെയ്യാം, ഉദ്ദിഷ്‌ടഫലത്തിനുവേണ്ടിയുള്ള പ്രയോഗതന്ത്രം സോഫ്റ്റ്വെയർ എങ്ങനെ നിർമ്മിക്കാം, എങ്ങനെ ഇൻസ്റ്റാൾ ചെയ്യാം, അറിയപ്പെടുന്ന ഏതെങ്കിലും തകരാറുകൾ, ജോലിസ്ഥലങ്ങൾ എന്നിവയുടെ വിശദമായ വിവരണമാണ് ഫലം. ഈ പ്രമാണ നിർമ്മാണം ഭാവിയിലെ കമ്പ്യൂട്ടർ പ്രോഗ്രാമുകൾ വികസിപ്പിക്കുന്നരെയും പരിപാലകരെയും സമയബന്ധിതമായി സോഫ്റ്റ്വെയർ വേഗത്തിലാക്കാൻ പ്രാപ്‌തമാക്കുന്നു. കൂടാതെ കോഡ് പരിഷ്‌ക്കരിക്കുന്നതിനോ ബഗുകൾക്കായി തിരയുന്നതിനോ ഒരു റോഡ്മാപ്പ് നൽകുന്നു.

നെറ്റ്വർക്ക് ഇൻവെന്ററി, കോൺഫിഗറേഷൻ (സിഎംഡിബി) എന്നിവയ്ക്കുള്ള സോഫ്റ്റ്വെയർ

ഈ സോഫ്റ്റ്വെയർ ഉപകരണങ്ങൾക്ക് നിങ്ങളുടെ നെറ്റ്‌വർക്ക് ഉപകരണങ്ങളുടെ ഡാറ്റ സ്വപ്രേരിതമായി ശേഖരിക്കാൻ കഴിയും. ഡാറ്റ ഇൻവെന്ററി, കോൺഫിഗറേഷൻ വിവരങ്ങൾ എന്നിവയായിരിക്കാം. ഐടി ഉത്തരവാദിത്തമുള്ള എല്ലാ വിവരങ്ങൾക്കും അടിസ്ഥാനമായി അത്തരമൊരു ഡാറ്റാബേസ് സൃഷ്ടിക്കാൻ ഐടിഐഎൽ ലൈബ്രറി അഭ്യർത്ഥിക്കുന്നു. ഐടി ഡോക്യുമെന്റേഷന്റെ അടിസ്ഥാനം കൂടിയാണിത്. XIA കോൺഫിഗറേഷൻ ഉദാഹരണങ്ങളിൽ ഉൾപ്പെടുന്നു.[15].

ക്രിമിനൽ നിയമത്തിലെ ഡോക്യുമെന്റേഷൻ[തിരുത്തുക]

ക്രിമിനൽ ഡാറ്റാബേസുകൾ ജനകീയമാക്കുന്നതിനുള്ള പ്രക്രിയയാണ് "ഡോക്യുമെന്റേഷൻ". നാഷണൽ കൗണ്ടർ-ടെററിസം സെന്ററിന്റെ ടെററിസ്റ്റ് ഐഡന്റിറ്റീസ് ഡാറ്റമാർട്ട് എൻവയോൺമെന്റ് ("ടൈഡ്") ("TIDE"), ലൈംഗിക കുറ്റവാളികളുടെ രജിസ്ട്രികൾ, സംഘ ഡാറ്റാബേസുകൾ എന്നിവ ഉദാഹരണം.[16]

ആദ്യകാല ബാല്യകാല വിദ്യാഭ്യാസത്തിലെ ഡോക്യുമെന്റേഷൻ[തിരുത്തുക]

"ലോകത്തെക്കുറിച്ചുള്ള കുട്ടികളുടെ ആശയങ്ങൾ, ചിന്തകൾ, ചോദ്യങ്ങൾ, സിദ്ധാന്തങ്ങൾ എന്നിവ ശ്രദ്ധിക്കുകയും വിലമതിക്കുകയും തുടർന്ന് വിശാലമായ ഒരു കമ്മ്യൂണിറ്റിയുമായി പങ്കിടുന്നതിന് അവരുടെ പ്രവർത്തനങ്ങൾ (ഡ്രോയിംഗുകൾ, കുട്ടികളുടെ ഫോട്ടോകൾ, അവരുടെ പ്രവർത്തനങ്ങളുടെ പകർപ്പുകൾ) ശേഖരിക്കുകയും ചെയ്യുന്നതാണ്" ആദ്യകാല ബാല്യകാല വിദ്യാഭ്യാസ മേഖലയുമായി ബന്ധപ്പെട്ട ഡോക്യുമെന്റേഷൻ.[17]

ഇതും കാണുക[തിരുത്തുക]

കുറിപ്പുകൾ[തിരുത്തുക]

  1. N/A (2003). "Guide to Documentation" (PDF). മൂലതാളിൽ (PDF) നിന്നും 29 July 2007-ന് ആർക്കൈവ് ചെയ്തത്.
  2. CGRP. "A Guide to Documentation Styles" (PDF). ശേഖരിച്ചത് 12 June 2009.
  3. N/A. "A guide to MLA documentation" (PDF). മൂലതാളിൽ (PDF) നിന്നും 2 September 2006-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 12 June 2009.
  4. Berger, David. "Procedures and Documentation" (PDF). മൂലതാളിൽ (PDF) നിന്നും 27 ജൂലൈ 2011-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 15 ജൂൺ 2009.
  5. Springhouse (2008). Complete Guide to Documentation. ISBN 9781582555560. ശേഖരിച്ചത് 12 June 2009.
  6. Tampere University of Technology. "Thesis Writing at the Tampere University of Technology" (PDF). ശേഖരിച്ചത് 12 June 2009.
  7. Faculty of Veterinary Medicine, University of Prince Edward Island. "A Guide for the Writing of Graduate Theses" (PDF). മൂലതാളിൽ (PDF) നിന്നും 5 ജൂൺ 2011-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 12 ജൂൺ 2009.
  8. University of Waikato. "Writing and Submitting a Dissertation or Thesis at the University of Waikato" (PDF). മൂലതാളിൽ (PDF) നിന്നും 9 ഡിസംബർ 2008-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 12 ജൂൺ 2009.
  9. Journal of Food Science. "Manuscript Submission". മൂലതാളിൽ നിന്നും 25 മേയ് 2009-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 12 ജൂൺ 2009.
  10. Analytical Chemistry. "Information for Authors". ശേഖരിച്ചത് 12 June 2009.
  11. Cropper, Mark; Tony Dibbens (2002). "GAIA-RVS Documentation Procedures" (PDF). മൂലതാളിൽ (PDF) നിന്നും 2 നവംബർ 2005-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 15 ജൂൺ 2009.
  12. N/A. "GLNPO's Quality System Documentation Review Procedures and Tracking" (PDF). മൂലതാളിൽ (PDF) നിന്നും 4 December 2008-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 15 June 2009.
  13. UK Data Archive (2009). "Data Services Process Guides: Documentation Processing Procedures" (PDF). മൂലതാളിൽ (PDF) നിന്നും 13 ജൂൺ 2010-ന് ആർക്കൈവ് ചെയ്തത്. ശേഖരിച്ചത് 15 ജൂൺ 2009.
  14. UK Data Archive. "Data Services Process Guides: Documentation Processing Techniques" (PDF). ശേഖരിച്ചത് 15 June 2009.[പ്രവർത്തിക്കാത്ത കണ്ണി]
  15. "XIA Configuration Network Documentation Tool". ശേഖരിച്ചത് 8 August 2017.
  16. Rader Brown, Rebecca (2009). "The Gang's All Here: Evaluating the Need for a National Gang Database". Columbia Journal of Law and Social Problems. 42: 293–333.
  17. Susan, Stacey (2015-05-11). Pedagogical documentation in early childhood : sharing children's learning and teachers' thinking. St. Paul, Minnesota. ISBN 9781605543925. OCLC 909907917.

പുറത്തേക്കുള്ള കണ്ണികൾ[തിരുത്തുക]

"https://ml.wikipedia.org/w/index.php?title=ഡോക്യുമെന്റേഷൻ&oldid=3213736" എന്ന താളിൽനിന്ന് ശേഖരിച്ചത്