タグ

documentに関するch1248のブックマーク (9)

  • FFmpegの基本的な使い方 | NM Maxのブログ


    FFmpeg (2)  https://ffmpeg.org/ffmpeg.html  https://ffmpeg.org/ffmpeg-filters.html ffmpeg 調使ffmpeg使 wiki https://trac.ffmpeg.org/wiki/ FFmpegFiltering Guide https://t
    ch1248
    ch1248 2022/09/16
    ffmpegの使い方まとめ。
  • HTTP | MDN

    HTTP Guides Resources and URIs Identifying resources on the Web Data URLs Introduction to MIME types Common MIME types Choosing between www and non-www URLs HTTP guide Basics of HTTP Overview of HTTP Evolution of HTTP HTTP Messages A typical HTTP session Connection management in HTTP/1.x Protocol upgrade mechanism HTTP security Content Security Policy (CSP) HTTP Strict Transport Security (HSTS) X-

    HTTP | MDN
  • The Rust Programming Language 日本語版 - The Rust Programming Language 日本語版


    The Rust Programming Language  Steve KlabnikCarol NicholsRust Rust 1.582022113使 Rust1 HTMLhttps://doc.rust-lang.org/stable/book/ rustupRust使rustup docs --book HTMLhttps://doc.rust-jp.rs/book-ja/ rustup使 
    ch1248
    ch1248 2022/07/02
    Rust関連
  • ドキュメントに固執せよ - gfnweb

    どうして人間集団はこんなにも知見の共有を円滑にできないのか? 改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい. ここでテーマにしているのは,著名OSSなど世の中にいくらでも知見が転がっている対象ではなく,特に企業内の十数人のチームでクローズドに開発しているなどして集合知に頼れない状況下でのドキュメントについてである. 非常に乱暴な言い方をするなら,「コードとか大部分は誰でも書けるようになるものなんよ,そんなところにマッチョイズムとか感じなくてええねん,我々の知的体力や組織性が真に試されるのはドキュメントちゃうんか」という気持ちです — 画力・博士号・油田 (@bd_gfngfn) June 3, 2022 ドキュメントに書く内容の必須項目或るシステム(ソフトウェアなど)について,そのシステムのことを全く知らない人を想定読者としたドキュメント

    ch1248
    ch1248 2022/06/18
    同意できる。
  • わかりやすいシステム構成図の書き方 - Qiita

    わかりにくいシステム構成図とは こんなシステム構成図を書いてないでしょうか? このシステム構成図のわかりにくい点が3つあります。それは 製品名は書いてあるが「役割」が書いていない データと処理が区別できない データの流れと制御の流れが区別できない の3つです。 わかりやすいシステム構成図 これら3つのわかりにくい点を改善したわかりやすいシステム構成図が↓です ポイントを解説していきます ポイント1. 製品名称ではなく「役割」を書く システム構成図には製品名称ではなくシステムコンポーネントの「役割」を書きます。 役割とは、例えば〇〇データや〇〇処理といったことであり、それを読むだけでシステムの動きを理解できる文字列です。役割をかかずに製品名称のみを書いてしまうと、その製品を知らない人が見たときに理解できません。例えば「Cloud Pub/Sub」という製品はGCPというパブリッククラウドの分

    わかりやすいシステム構成図の書き方 - Qiita
    ch1248
    ch1248 2022/06/13
    良い資料だ。
  • テクニカルライティングの基本


     Twitterhttps://twitter.com/naoh_nak 2023https://speakerdeck.com/naohiro_nakata/technicalwriting2023
    テクニカルライティングの基本
    ch1248
    ch1248 2022/06/10
    たいへん良い資料だ。
  • 開発ドキュメントの書き方!9つのコツ【エンジニア】


      39 使使
    開発ドキュメントの書き方!9つのコツ【エンジニア】
  • 信用できる社内 Wiki をつくるために守ってほしい、たったひとつのルール - 無印吉澤


     Wiki Wiki  muziyoshiz.hatenablog.com   Wiki   Wiki 使 Wiki   1
    信用できる社内 Wiki をつくるために守ってほしい、たったひとつのルール - 無印吉澤
  • ドキュメント作成時のあるあるアンチパターン20 - Qiita

    業務でドキュメントを作成するケースは多々ある 例:仕様書・設計書・提案書・メール・障害票... ここでは各ドキュメント共通してありがちなアンチパターンをまとめてみました。 1. 表記がバイト表示・マイクロ秒表示 プログラムが出した数値をありのままに表示するパターン ファイルサイズが100MB, 1GBあろうと、バイト表示にする 桁数が多い数値に、桁区切り(,)を入れない 時間を何でもマイクロ秒・ミリ秒にする(1/100万秒までの精度が必要?体感で分かる?) 桁数が多い=精度が高い=良い文書、ではなく、見る人が必要とする精度に切り上げることが重要(売上で1円単位まで出すことが無いのと同様) 悪い例 No ファイル名 ファイルサイズ(byte) 処理時間(秒)

    ドキュメント作成時のあるあるアンチパターン20 - Qiita
    ch1248
    ch1248 2016/10/03
    すっげえ耳が痛い……。
  • 1