수정 사항 | |
---|---|
그림 목차와 표 목차 추가 | |
불필요한 이미지 줄이기 | |
"특징 및 장점" 명확하지 않은 표현 수정 | |
노트 주의 참고 박스 설명 | |
순서에 결과가 들어가있는 부분 수정 | |
용어 설명 위로 빼기 | |
"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) 실습