見出し画像

学び(2024/06/07)

今日の学び

  • ドキュメント整備の話

    • 必要なドキュメントの洗い出し

    • 優先順位をつける

    • ルールの制定

      • ディレクトリ名やファイル名のルール

      • ページ名被りの避け方

      • 周知のルール

    • ドキュメント作成の負担を低減する

  • slack通知を実際に使ってみる話

    • メンション通知を受け取れる

    • DBのページ追加らプロパティ更新をトリガーにできる

所感

ドキュメント整備の目標はこんな感じだろうか?

  • 構造認識の共有

    • 誰でもどこに何がありそうかがなんとなくわかる

  • ドキュメントの一生が設計されている

    • 不要になった情報は削除され、重要な情報は人目に付きやすくなる

実際どういう風に進めるのがいいのか試してみたいかも。

  • ドキュメントDBみたいなのを作って、そこに作成したドキュメントは追加したら通知が飛ぶ。

  • ドキュメント状態のプロパティを作って、新規追加、資料更新、削除予定とかライフサイクルと資料の最終更新日の変更で通知が飛ぶようにできれば、どれがホットな資料かわかったりしないか。


この記事が気に入ったらサポートをしてみませんか?