Mục lục:

Bạn chuẩn bị tài liệu kỹ thuật như thế nào?
Bạn chuẩn bị tài liệu kỹ thuật như thế nào?

Video: Bạn chuẩn bị tài liệu kỹ thuật như thế nào?

Video: Bạn chuẩn bị tài liệu kỹ thuật như thế nào?
Video: Cách Làm Nem Chua Đơn Giản Tại Nhà, Chuẩn Vị Nem Chua Thanh Hóa | Góc Bếp Nhỏ 2024, Tháng mười một
Anonim

Viết cho khán giả của bạn: 6 bước để tạo tài liệu kỹ thuật sẽ được sử dụng

  1. Lập kế hoạch. Biết mục đích và phạm vi của dự án trước khi bạn bắt đầu.
  2. Đang soạn thảo. Bắt đầu với một dàn ý cấp cao về tất cả các chủ đề được đề cập.
  3. Đang đánh giá.
  4. Đang sửa đổi.
  5. Chỉnh sửa.
  6. Xuất bản / Bảo trì.

Đơn giản như vậy, những gì nên được bao gồm trong tài liệu kỹ thuật?

Kỹ thuật văn bản bao gồm một loạt các tài liệu. Chúng bao gồm hướng dẫn, đánh giá, báo cáo, bản tin, bản trình bày, trang web, tài liệu quảng cáo, đề xuất, thư, tờ rơi, đồ họa, bản ghi nhớ, thông cáo báo chí, sổ tay, thông số kỹ thuật, hướng dẫn phong cách, chương trình nghị sự, v.v.

Ngoài ra, bạn chuẩn bị tài liệu cho một dự án như thế nào? Các phương pháp hay nhất để lập hồ sơ dự án của bạn

  1. Bao gồm một tệp README có chứa.
  2. Cho phép trình theo dõi vấn đề cho những người khác.
  3. Viết tài liệu API.
  4. Ghi lại mã của bạn.
  5. Áp dụng các quy ước mã hóa, chẳng hạn như tổ chức tệp, nhận xét, quy ước đặt tên, thực hành lập trình, v.v.
  6. Bao gồm thông tin cho những người đóng góp.

Thứ hai, tạo tài liệu kỹ thuật là gì?

Tài liệu kỹ thuật đề cập đến bất kỳ tài liệu giải thích việc sử dụng, chức năng, sáng tạo, hoặc kiến trúc của một sản phẩm. Hãy coi nó như một hướng dẫn "cách thực hiện" rất bổ ích cho người dùng, nhân viên mới, quản trị viên và bất kỳ ai khác cần biết sản phẩm của bạn hoạt động như thế nào.

Làm cách nào để cải thiện kỹ năng tài liệu của tôi?

Vì vậy, đây là một vài mẹo đơn giản và nhanh chóng để giúp bạn và nhóm của bạn cải thiện tài liệu của bạn ngay lập tức

  1. Mẹo 1) Thoát bằng giọng nói bị động.
  2. Mẹo 2) Sử dụng Hình ảnh Đơn giản để Thu hút Người đọc của bạn.
  3. Mẹo 3) Sử dụng Tiêu đề và Dấu đầu dòng hay.
  4. Mẹo 4) Chế ngự các Từ viết tắt và Từ Buzz của bạn.
  5. Mẹo 5) Sử dụng Tiêu chuẩn hiệu quả.

Đề xuất: