একটি সর্বব্যাপী ভাষা কীভাবে ডকুমেন্ট করবেন?


14

আমাদের সংস্থা অনেকগুলি ম্যানুয়াল ব্যবসায়ের প্রক্রিয়াগুলি (এবং সম্পর্কিত প্রাতিষ্ঠানিক জ্ঞান) কে নতুন এন্টারপ্রাইজ সফ্টওয়্যারে রূপান্তর করার প্রক্রিয়াধীন। প্রকল্পটি সত্যিই ভাল চলছে, তবে আমরা এগিয়ে যাওয়ার সাথে এটা স্পষ্ট যে ব্যবসায় এবং বিকাশের উভয় পক্ষেই শর্তাবলী এবং সংজ্ঞা নিয়ে অনেক বিভ্রান্তি রয়েছে।

আমি কিছু সময়ের জন্য সর্বব্যাপী ভাষা গঠনের জন্য ইভানের যুক্তি সম্পর্কে সচেতন ছিলাম, তবে এগুলি আনুষ্ঠানিকভাবে নথিভুক্ত করার জন্য আমার এই প্রথম প্রয়োজন। আমি যখন চারপাশে তাকিয়ে দেখি এবং কোথায় / কীভাবে আমাদের উল শর্তাদি নথিভুক্ত করতে হয় সে সম্পর্কে ভাবতে চেষ্টা করি, আমি একধরণের হারিয়েছি।

অন্যান্য সংস্থাগুলি কীভাবে সর্বব্যাপী ভাষা নথি করে? এটি কি কেবল উইকি-স্টাইলের অভিধান? এই উদ্দেশ্যে কিছু সরঞ্জাম আছে কি?


1
এটি একটি ভাল শুরু: thepaulrayner.com/blog/2013/05/07/… । আমি বিশেষত এই উত্তরণটি পছন্দ করি: "গুরুত্বপূর্ণ বিষয়টি এমন হওয়া উচিত নয় যে ডোমেনটি নথিভুক্ত করা হয়, এটি এটি বোঝা যায় এবং সফ্টওয়্যারটি বিকাশের সাথে সংযুক্ত প্রত্যেকের মধ্যে এই বোঝাপড়াটি ভাগ করা হয়" "
রবার্ট হার্ভে

বাহ - কি দুর্দান্ত প্রশ্ন। আমার যদি এই প্রশ্নটি থাকে তবে আমি ইভেন্টস্টোর্মিংয়ের দিকে নজর রাখব এবং দেখুন যে প্রক্রিয়াটির ফলাফলগুলি দলিল করার কোনও বুদ্ধিমান উপায় আছে কিনা।
ভয়েসঅফঅনরেজন

উত্তর:


4

আপনি একটি সফ্টওয়্যার কাস্টমাইজেশন প্রকল্প হিসাবে "সর্বব্যাপী ভাষা ডকুমেন্টেশন" হিসাবে বিবেচনা করতে পারেন: আপনাকে ডকুমেন্টেশন ম্যানেজমেন্টের জন্য কিছু সফ্টওয়্যার নিতে হবে এবং এটি আপনার নির্দিষ্ট প্রয়োজনের সাথে খাপ খাইয়ে নিতে হবে। সফ্টওয়্যার প্রকল্পগুলিতে আপনি সাধারণত ব্যবহারকারীর প্রয়োজনগুলি সংগ্রহ করে শুরু করেন, তারপরে আপনি তথ্য আর্কিটেকচার এবং নকশা সমাধান তৈরি করেন এবং তারপরে আপনি বাস্তবায়নের দিকে এগিয়ে যান। নীচে এই প্রক্রিয়াটির উদাহরণ দেওয়া হল।

এর জন্য ব্যবহারকারীর কী প্রয়োজন? কিছু সংস্থায় বিভিন্ন ডোমেন থেকে বিভিন্ন ফাংশনযুক্ত লোকেরা তাদের সমস্যা এবং সমাধানগুলি বর্ণনা করার জন্য সাধারণ ভাষার উপভাষা ব্যবহার করতে চান। এই উপভাষাটি কেবল তার শব্দভাণ্ডার (শব্দ এবং কথার পরিসংখ্যান) দ্বারা সংজ্ঞায়িত করা হবে, যেহেতু এখানে উচ্চারণ সম্ভবত গুরুত্বপূর্ণ নয় এবং ব্যাকরণটি ভাষার সাহিত্যের ফর্মের উপর ভিত্তি করে তৈরি হবে। উপভাষার ডকুমেন্ট করতে আপনার একটি ডকুমেন্টেশন কাঠামো ডিজাইন করতে হবে যা শব্দভাণ্ডার পরিচালনার জন্য সবচেয়ে উপযুক্ত হবে (শর্তাবলীর শব্দকোষ)।

শব্দ বা সংক্ষিপ্ত বিবরণটির অর্থ শেখার জন্য, এর প্রতিশব্দ বা সংজ্ঞা অনুসারে সঠিক শব্দটি খুঁজে পেতে বা ডোমেনটি রচনা করে এমন সমস্ত শব্দ শিখতে লোকেরা এই ডকুমেন্টেশনটি ব্যবহার করতে পারে।

এই ব্যবহারকারীর প্রয়োজনের জন্য, উইকি প্রকৃতপক্ষে একটি ভাল পছন্দ। কিভাবে এটি উপযুক্ত? কনফ্লিউয়েন্স বা মিডিয়াউইকের মতো ভাল উইকি সিস্টেমে এটি সম্ভব:

  • প্রতিটি পদে একটি নিবন্ধ তৈরি করুন।
  • কিছু টেমপ্লেটে নিবন্ধগুলির সাধারণ কাঠামো সংজ্ঞায়িত করুন, যাতে সেগুলিতে কিছু সাধারণ বিভাগ থাকবে, যা সমষ্টি জন্য ব্যবহৃত হতে পারে।
  • অন্যান্য উইকি নিবন্ধগুলিতে টার্ম সংজ্ঞাগুলিতে সহজেই লিঙ্ক যুক্ত করুন।
  • শব্দ সংজ্ঞা সহ সামগ্রিক সারণীগুলি তৈরি করুন এবং এগুলিকে অন্য ডকুমেন্টেশনে এম্বেড করুন।

বর্তমানে আমি তথ্য আর্কিটেকচার ডকুমেন্টিংয়ের জন্য সঙ্গম ব্যবহার করছি এবং সর্বব্যাপী ভাষার সংজ্ঞা এর অংশ are এই ডকুমেন্টেশনের সর্বাধিক স্তর হ'ল ডোমেন নিবন্ধ। প্রতিটি প্রয়োগে একাধিক ডোমেন রয়েছে, যেমন সুরক্ষা, অর্থ প্রদান ইত্যাদি These এই ডোমেনগুলি সিস্টেমের সাথে ব্যবহারকারীর অনেকগুলি মিথস্ক্রিয়া দ্বারা সংজ্ঞায়িত হয়, যা সর্বব্যাপী ভাষার মাধ্যমে বর্ণিত হতে পারে, তাই আমি এই মিথস্ক্রিয়াগুলির সংজ্ঞা পৃথক উপ-পৃষ্ঠাতে এবং সংজ্ঞাগুলিতে রেখেছি ইন্টারঅ্যাকশন পৃষ্ঠাগুলির উপ-পৃষ্ঠাতে এই ইন্টারঅ্যাকশনগুলির দ্বারা শর্তাদি চালু করা হয়েছে। আমি প্যারেন্ট পৃষ্ঠাগুলিতে সামগ্রিক সারণীগুলি রেখেছি যাতে এটি দেখা সম্ভব হয়, উদাহরণস্বরূপ, কোন পরিস্থিতিতে কোন ডোমেন থাকে এবং এর মধ্যে কোন শর্তাদি সংজ্ঞায়িত হয়।

যখন এই ডকুমেন্টেশন কাঠামোটি সম্পন্ন হয় এবং আমি আরও বিশদ সিস্টেমের স্পেসিফিকেশনগুলিতে যাই, আমি কেবল দৃশ্যের আইএ এবং ইউএল সংজ্ঞাগুলিকে উল্লেখ করতে পারি যেমন "উপাদান একটি সিস্টেম বি এর সাথে ইন্টারঅ্যাকশন সংহতকরণের জন্য ইন্টারঅ্যাকশন সি (আইএ দৃশ্যের লিঙ্ক) সম্পর্কে তথ্য পাস করে জেড (উল লিঙ্ক) "।

আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.