タグ

ドキュメントに関するmacorityのブックマーク (4)

  • ナレッジマネジメントを組織に定着させるための提案|國光俊樹

    この記事はGoodpatchアドベントカレンダー2022の23日目の記事です。 突然ですが、私は昨年「ナレッジマネジメント」領域の新規事業を立案し、リサーチや価値検証を行いました。結果としてはβ版を複数社に導入していただきながら行った価値検証を経てクローズという判断になってしまったものの、そのプロセスを通じて様々な組織におけるナレッジマネジメントの状況や課題感、そしてベストプラクティスまで多くの知見を得ることができました。 今回はそういった経験を土台として、これまで発信の主テーマにしていた「UXデザイン」や「サービスデザイン」の領域ではなく「ナレッジマネジメント」というテーマで記事を執筆することにしました。 この記事では、組織としてナレッジマネジメントを推進する時にどのような観点や考え方が必要なのかを紐解いていけたらと思います。 (組織の状況やカルチャー、事業形態などによっても最適なHOW

    ナレッジマネジメントを組織に定着させるための提案|國光俊樹
  • テクニカルライティングの基本

    テクニカルライティングの基を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter:https://twitter.com/naoh_nak 2023年度のアップデート版もあります:https://speakerdeck.com/naohiro_nakata/technicalwriting2023

    テクニカルライティングの基本
  • PlantUMLのテーマ(思わぬ展開) | フューチャー技術ブログ

    秋のブログ週間連載の7目です。 はじめにPlantUMLで使えるテーマについてのご紹介です。 以前、チームで機能設計するためのPlantUML標準化の記事でも書かせていただきましたが、PlantUMLのデフォルトカラーって少しドライですよね。 色の好みは人それぞれで、あれはあれでカッコよさはありますが、複雑な図は少しでも可愛く描きたい・楽しく見たいものです。 この記事ではPlantUMLのテーマについて、いくつかのオプションを紹介していきます。「PlantUMLの色を変えてみたい!」という方は是非ご活用いただければ嬉しいです。 前提 PlantUMLでは、skinparamを利用して図のビジュアル各要素を定義しますが、「テーマ」はskinparamの集合体です この記事ではテーマの作り方や、各運用方法等については触れません この記事で紹介するオリジナルテーマはシーケンス図のために作られた

    PlantUMLのテーマ(思わぬ展開) | フューチャー技術ブログ
  • 自己流の手順書フォーマットを公開してみた | DevelopersIO

    手順書フォーマットは千差万別 みなさんは自己流または、組織やプロジェクトで定められた手順書のフォーマットはありますか? 私は自己流の手順書フォーマットがあります。 自己流の手順書フォーマットがあるといっても、かなり扱いがふわふわしているので、備忘やメモの意味合い強めでまとめていきます。 「もっとこうした方がいいよ!!」などフィードバックがあれば、ぜひお願いします! いきなりまとめ 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書はgitで管理する 5W1Hを意識して手順書を書く 基的にはCLIを使った手順書にする 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書をExcelやスプレッドシートで書くメリット・デメリット 手順書をExcelやスプレッドシートで書いている方も多いと思いますが、私はMarkdownで書いています。 Exce

    自己流の手順書フォーマットを公開してみた | DevelopersIO
    macority
    macority 2021/07/16
    Markdownは図とか表が使いずらいのよね。むしろExcelはOneDrive置いとけば履歴管理されるし、校閲でコメント入れれたりデメリットが減ってる気がする
  • 1