Мазмуну:

Сиз техникалык документтерди кантип даярдайсыз?
Сиз техникалык документтерди кантип даярдайсыз?

Video: Сиз техникалык документтерди кантип даярдайсыз?

Video: Сиз техникалык документтерди кантип даярдайсыз?
Video: Как заполнить карточку учета выдачи СИЗ? 2024, Ноябрь
Anonim

Аудиторияңыз үчүн жазуу: Колдонула турган техникалык документацияны түзүү үчүн 6 кадам

  1. Пландоо. Баштоодон мурун долбоордун максатын жана көлөмүн билип алыңыз.
  2. Долбоорлоо. Бардык темалар боюнча жогорку деңгээлдеги пландан баштаңыз.
  3. карап чыгуу.
  4. Кайра карап чыгуу.
  5. Түзөтүү.
  6. Жарыялоо/Кызматтоо.

Жөнөкөй эле, техникалык документтерге эмнелер киргизилиши керек?

Техникалык жазуу документтердин кенен спектрин камтыйт. Алар инструкцияларды, сын-пикирлерди, отчетторду, маалымат бюллетендерин, презентацияларды, веб-баракчаларды, брошюраларды, сунуштарды, каттарды, баракчаларды, графикаларды, эскертмелерди, пресс-релиздерди, маалымдамаларды, спецификацияларды, стилдик колдонмолорду, күн тартибин жана башкаларды камтыйт.

Кошумчалай кетсек, долбоор үчүн документтерди кантип даярдайсыз? Долбооруңузду документтештирүү үчүн мыкты тажрыйбалар

  1. камтыган README файлын кошуңуз.
  2. Башкалар үчүн маселени көзөмөлдөөчүгө уруксат берүү.
  3. API документациясын жазыңыз.
  4. Кодуңузду документтештириңиз.
  5. Файлдарды уюштуруу, комментарийлер, ат коюу конвенциялары, программалоо практикасы ж.б. сыяктуу коддоо конвенцияларын колдонуңуз.
  6. салым кошкондор үчүн маалымат камтууга.

Экинчиден, техникалык документтерди түзүү деген эмне?

Техникалык документация каалаганын билдирет документ буюмдун колдонулушун, функционалдуулугун, түзүлүшүн, же архитектурасын түшүндүрөт. Аны колдонуучуларыңыз, жаңы жумушка орношкондоруңуз, администраторлоруңуз жана өнүмүңүздүн кандайча иштешин билиши керек болгон башка адамдар үчүн "кантип кылуу керек" колдонмосу деп ойлоңуз.

Мен кантип документтештирүү көндүмдөрүн жакшыртсам болот?

Ошентип, бул жерде сизге жана сиздин командаңызга документтериңизди дароо жакшыртууга жардам бере турган бир нече жөнөкөй жана тез кеңештер бар

  1. Кеңеш 1) Пассивдүү үн менен аны токтотуңуз.
  2. Кеңеш 2) Окурманыңызды кызыктыруу үчүн жөнөкөй визуалдарды колдонуңуз.
  3. Кеңеш 3) Улуу аталыштарды жана маркерлерди колдонуңуз.
  4. Кеңеш 4) Акронимдерди жана Buzz Сөздөрүңүздү үйрөтүңүз.
  5. Кеңеш 5) Кайра иштетүү стандартын колдонуңуз.

Сунушталууда: