Სარჩევი:

რა არის წყაროს კოდის დოკუმენტაცია?
რა არის წყაროს კოდის დოკუმენტაცია?

ვიდეო: რა არის წყაროს კოდის დოკუმენტაცია?

ვიდეო: რა არის წყაროს კოდის დოკუმენტაცია?
ვიდეო: Code Documentation Be Like... 2024, მაისი
Anonim

პროგრამული უზრუნველყოფა დოკუმენტაცია არის დაწერილი ტექსტი ან ილუსტრაცია, რომელიც თან ახლავს კომპიუტერულ პროგრამულ უზრუნველყოფას ან ჩართულია მასში საწყისი კოდი . The დოკუმენტაცია ან განმარტავს, თუ როგორ მუშაობს პროგრამული უზრუნველყოფა ან როგორ გამოიყენოს იგი, და შეიძლება ნიშნავდეს განსხვავებულს სხვადასხვა როლის მქონე ადამიანებისთვის. არქიტექტურა/დიზაინი – პროგრამული უზრუნველყოფის მიმოხილვა.

ამის გათვალისწინებით, როგორ ახდენთ დოკუმენტების კოდირებას?

დოკუმენტაციის დაწერის საუკეთესო პრაქტიკა:

  1. ჩართეთ README ფაილი, რომელიც შეიცავს.
  2. დაუშვით საკითხის ტრეკერი სხვებისთვის.
  3. დაწერეთ API დოკუმენტაცია.
  4. დააფიქსირეთ თქვენი კოდი.
  5. გამოიყენეთ კოდირების კონვენციები, როგორიცაა ფაილების ორგანიზაცია, კომენტარები, დასახელების კონვენციები, პროგრამირების პრაქტიკა და ა.შ.
  6. ჩართეთ ინფორმაცია კონტრიბუტორებისთვის.

შეიძლება ასევე იკითხოთ, რა არის მომხმარებლის დოკუმენტაცია? მომხმარებლის დოკუმენტაცია ეხება დოკუმენტაცია საბოლოო მომხმარებლებისთვის მიწოდებული პროდუქტის ან მომსახურებისთვის. The მომხმარებლის დოკუმენტაცია შექმნილია იმისთვის, რომ დაეხმაროს საბოლოო მომხმარებლებს გამოიყენონ პროდუქტი ან მომსახურება. ამას ხშირად უწოდებენ მომხმარებელი დახმარება. The მომხმარებლის დოკუმენტაცია არის მომხმარებლისთვის მიწოდებული მთლიანი პროდუქტის ნაწილი.

ამის გათვალისწინებით, რა სახის დოკუმენტაცია არსებობს?

ტიპები სისტემის დოკუმენტაცია მოიცავს მოთხოვნებს დოკუმენტი , საწყისი კოდი დოკუმენტი , ხარისხის გარანტია დოკუმენტაცია , პროგრამული არქიტექტურა დოკუმენტაცია , გადაწყვეტის ინსტრუქციები და დამხმარე სახელმძღვანელო მოწინავე მომხმარებლებისთვის. ტიპები მომხმარებლის დოკუმენტაცია მოიცავს სასწავლო სახელმძღვანელოებს, მომხმარებლის სახელმძღვანელოებს, გამოშვების შენიშვნებს და ინსტალაციის სახელმძღვანელოებს.

რა უნდა იყოს შეტანილი პროგრამული უზრუნველყოფის დოკუმენტაციაში?

რა უნდა შეიტანოთ თქვენს დოკუმენტაციაში

  1. ახსნა, თუ რას აკეთებს თქვენი პროგრამული უზრუნველყოფა და რა პრობლემას წყვეტს იგი.
  2. მაგალითი, რომელიც ასახავს იმ გარემოებებს, რომლებშიც თქვენი კოდი ჩვეულებრივ გამოიყენებოდა.
  3. ბმულები კოდისა და შეცდომების ტრეკერზე.
  4. ხშირად დასმული კითხვები და მხარდაჭერის მოთხოვნის გზები.
  5. ინსტრუქციები, თუ როგორ დააინსტალიროთ თქვენი პროგრამული უზრუნველყოფა.

გირჩევთ: