Future Tech Blog
フューチャー技術ブログ
Home
Tags
ドキュメント
ドキュメント
タグの記事
10
投稿
6
著者数
1830
総シェア数
124
Twitter
13
Facebook
1102
はてブ
591
Pocket
「言語化」を考える
本記事は「秋のブログ週間2024」3週目の記事です。![30648442_s.jpg]2023年4月にキャリア入社した曽田です。
2024.11.12
ドキュメント
言語化
ビジネス
思考法
資料作成
ツイート
シェア
3
6
ドキュメント管理を制する 陳腐化を防ぐための実践事例 Lunch LT に登壇しました
Findyさん主催のドキュメント管理を制する 陳腐化を防ぐための実践事例 Lunch LTに「設計ドキュメント腐る問題、Git管理で運用してみた本当のところ」というタイトルで登壇しました
2023.12.15
登壇レポート
ドキュメント
開発手法
ツイート
シェア
3
4
設計ドキュメント腐る問題、Git管理で運用してみた結果
設計ドキュメントをGit管理して腐らせないようにがんばってみた話をします
2023.11.01
ドキュメント
Git
設計
ツイート
13
459
201
markdownlintで設計書の品質を高める
Markdownで設計書を充実させようとすればするほど、設計書間やメンバー間のちょっとした揺れで、本質的なレビューがしにくく感じるようになりました。そこでMarkdownのLintツールを導入するモチベーションが高まりました。
2023.04.17
Markdown
ドキュメント
Linter
Markdownlint
ツイート
シェア
185
106
Go 1.19リリース連載始まります GoDoc/ツール周りのアップデート
Go 1.18のジェネリクス導入の大規模リリースと比べると比較的小さな1.19ですが、それでもさまざまな変更があります。今回ももちろん、恒例行事になりつつある、このテックブログでリリース連載をやります。まずは、GoDocと、その他ツール周りのアップデートの紹介です。
2022.08.01
インデックス
Go言語
ドキュメント
GoDoc
Go1.19
79
シェア
46
29
技術情報の調べ方
業務を進める上では日々多くの技術情報を調べる必要がありますが、無策に調べると時間を浪費したりイマイチな解決策を採用してしまう可能性があります。そこで、本稿では普段私がやっている方法を中心に、調べる上でのポイントを紹介します。
2022.04.21
ドキュメント
入門
新人向け
トラブルシュート
4
シェア
2
18
ユーザーストーリーマッピングで始める要求整理
ユーザーストーリーマップがあると、全体像の認識をチーム全体で共有できて便利です。ユーザーストーリーマップは視覚的にわかりやすく、特殊な構造もしていないため共通理解しやすいことがポイントです。また、ユーザーストーリーマップはこれから何を作ろうかという要求定義の段階でも有効に感じます。この記事では要求の整理と理解のためにユーザーストーリーマップを使ってみたときの気がついた点や振り返りをまとめました
2021.05.24
ドキュメント
チーム開発
ユーザーストーリーマッピング
アジャイル
27
シェア
16
36
CircleCIでMarkdownのリンク切れを自動検知する
私のチームでは、「システムの設計情報」や「実装に関わる業務知識」などを、`README.md` に整理して GitHub 管理しています。設計資料や業務系のドキュメントが蓄積され、何度も更新され続けることに伴い、「あれ、この資料のリンクが切れてる。オリジナルのファイルはどこだっけ?」と探す機会が増えてきました。本来ならば PullRequest のレビュー時に気付くべきですが、ファイル名のちょっとしたスペルミスや資料パスの変更などだと、目視でのチェックには限界があります。
2021.04.22
Markdown
ドキュメント
CircleCI
ツイート
シェア
4
4
Go Tips連載4: GoDocの読み方
新しいプログラミング言語を学ぶときは、まず、情報の取得の仕方を覚えておくと学習効率が上がります。検索して、日本語で誰かが解説している二次情報を探すのもいいのですが、古くなって使えなかったり、人気のある情報に偏ってしまって、ちょっと混み入った話になると情報が見つからなくなったりしがちです。多少素っ気なく感じるかもしれませんが、一次情報を読み解く方法を知っておくと良いでしょう。本家が作ったものではなくても網羅的に、リファレンスとなる心意気で書かれたものもたまにあります。
2020.05.21
Go言語
ドキュメント
GoTips連載
GoDoc
ツイート
シェア
32
29
実践Drawio
もともとはMicrosof VisioやExcelなどを使って作成していた図形(ネットワーク図、各種シーケンス、ERD..etc)ですが、ファイルストレージがクラウド(Google Driveなど)に移ることで、そのまま編集したい欲求が世の中で増しているように思います。その場合の有効なツールとしてdraw.ioを利用するケースが増えてきたと感じます。そこで当社で蓄積したナレッジを文章化します。
2020.01.16
ドキュメント
draw.io
ショートカット
14
シェア
352
158
1