Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.




수정 사항

그림 목차와 표 목차 추가

불필요한 이미지 줄이기

"특징 및 장점" 명확하지 않은 표현 수정

노트 주의 참고 박스 설명

순서에 결과가 들어가있는 부분 수정

용어 설명 위로 빼기

"6 일반적인 장애" 내용 제목 정리하기

2.1 메인화면 2.1.1 뒤에 없으니까 2.1.2가 없으면 목차에 내보내지말자

CLI는 부록으로

스텝은 최대 8~9개 넘지 말아야한다.

구성방법에 이걸 구성해야하는지 설명 짧게 넣기 아니면 설명이 있는 곳 링크를 걸어준다.

이미지는 작게해서 한 화면에서 보이게 해야하고 단 어디한곳 꼭지점을 포함해야 유저가 위치를 파악할 수 있다.


예시1: 소프트웨어 개발 키트(SDK) 가이드

예시2: 요구사항 분석서(SRS)


B2B 테크니컬 라이팅 이해하기

  • B2B 테크니컬 라이팅 개념 및 중요성
  • B2B 테크니컬 라이팅 절차
    • 계획세우기
      • 제목 정하기
        • 주제(Subject)와 목적(Purpose)을 포함해야 한다. 
      • 특정 독자 분석하기
        • 문서 작성 전 반드시 특정 독자를 분석
        • 해당 기술지식 수준, 직급, 주요관심항목
        • 기술 지식 수준이 높은 독자 + 기술 지식 수준이 낮은 독자
          • 두개의 문서로 분류하여 연결
            • 초급 독자 - Tutorial
            •  고급 독자 - Advanced Developer Guide
      • 작성 목적 분석하기
      • 종류 및 릴리즈 방식 결정하기
      • 목차 작성하기
    • 초안 작성
    • 수정
    • 편집 및 교정
  • B2B 테크니컬 라이팅 방법
  • 실습


기술내용 종류 및 작성방법

효과적인 국문 기술내용 작성을 위한 가이드라인

특정독자 위주의 기술내용 작성하기

SW 분야의 국, 영문 B2B  테크니컬 라이팅 교육

소프트웨어 개발키트(SDK) 가이드 실습

요구사항분석서(SRS) 실습