hisso.li
  • Login
Show Navigation
  • Public

    • Groups

Conversation

Notices

  1. まちカドおるみん御嬢様 (orumin@mstdn.maud.io)'s status on Thursday, 20-May-2021 19:30:34 JST まちカドおるみん御嬢様 まちカドおるみん御嬢様

    あと情報を口伝にしないためのシステム作り、ドキュメント作成と CI みたいな話だとこれも読んで >> ドキュメント作成システム構築ガイド[GitHub,RedPen,Asciidoctor,CIによる モダンライティング]:書籍案内|技術評論社 https://gihyo.jp/book/2016/978-4-7741-8036-6

    In conversation Thursday, 20-May-2021 19:30:34 JST from mstdn.maud.io permalink

    Attachments

    1. ドキュメント作成システム構築ガイド[GitHub,RedPen,Asciidoctor,CIによる モダンライティング]
      アプリケーションの開発手順,製品のユーザマニュアルなど,ドキュメントの多くはエンジニアによって作成されています。ドキュメントの品質が低い場合,読み手が誰であっても内容の理解に時間がかかります。ドキュメントは簡潔で内容を正確に伝えるものでなければなりません。 エンジニアにとってドキュメント作成は避けて通れません。いまやドキュメント作成はコーディングと同様にエンジニアに必要な技術なのです。本書は,ソフトウェア開発の技法に基づいてドキュメント作成を支援するシステムを構築します。このシステムではGitを用いたバージョン管理,GitHubによる共同編集,RedPenによる品質チェック,CIツールによる継続的改善などを利用します。 応用としてAsciidoctorによるドキュメントのスタイル調整について解説します。Webでの公開に耐える品質はもちろん,技術文書の電子出版においても役立つ内容となっています。
    • Help
    • About
    • FAQ
    • Privacy
    • Source
    • Version
    • Contact

    hisso.li is a social network. It runs on GNU social, version 2.0.0-alpha0, available under the GNU Affero General Public License.

    Creative Commons Attribution 3.0 All hisso.li content and data are available under the Creative Commons Attribution 3.0 license.

    Switch to desktop site layout.