目次
はじめに
バックパック：『Bellroy Transit Backpack Plus』
モバイルバッテリー兼充電器：『Anker 733 Power Bank』
無料Chromeプラグイン：『Tab Session Manager』
骨伝導イヤホン：『ゲオの激安骨伝導イヤホンGRFD-BCH BH330』
技術書：用件定義：『はじめよう！システム設計～要件定義のその後に』
技術書：『Web API: The Good Parts』
ノートPC：『13インチ M3 Macbook Air』
カードゲーム：『UNO』
モニターアーム：『サンワダイレクトモニターアーム 100-LAC003』
スマートフォン: 『iPhone16 Pro 128GB』
小説: 『エレファントヘッド』
小説：『松岡まどか、起業します　ＡＩスタートアップ戦記』
eSIM: 『Airlo』
資格：『ITパスポート』
漫画：『ミノタウルスの皿』
技術書：『Planning Algorithms』
サプリメント：『高濃度ビタミンＤ 60日分 2800IU (70μｇ) 太陽堂製薬』
参考資料
MyEnigma Supporters

はじめに

流行りにのって、書いてみたいと思います。

他の人の2024年買って良かったものばかり読んでいるので、自分も書くか。
— Atsushi Sakai (@Atsushi_twi) 2025年1月3日

買ったものだけじゃなく、読んだものや、使い始めてよかったソフト、

取得してよかった資格なども入ってますが。。。

2024-09-16

Diátaxis(ダイアタクシス)によるドキュメント分類入門

ユーザーの問題解決とプロダクトの成功を導く　エンジニアのためのドキュメントライティング

目次
はじめに
Diátaxisによる4つのドキュメント分類
- 1. Tutorial: 初心者のためのドキュメント
- 2. How-to guide: 特定のタスクを解決する例⁠
- 3. Technical reference: 参考資料; 定義や動作を示すもの
- 4. Technical explanation: 理解のための詳細なドキュメント
細かい注意点
- Diataxis マトリックス
- 4つのドキュメントの区別
参考資料
MyEnigma Supporters

はじめに

システムにとって、ドキュメントは非常に重要ですが、

複数人で、長い期間をかけて作成したドキュメントを、

わかりやすく分類するのは難しいと思います。

また、作成する側が、迷わずに目的のドキュメントを作成するための

指針を決めることも難しいことだと思います。

これを解決するために、提案されているのが、

diataxis.fr

Diátaxis(ダイアタクシス)です。

これはDaniele Procidaさんという、

Ubuntuを開発している、

Canonicalのテクニカルディレクターの方が

提案している方法です。

www.youtube.com

Diataxis は、

読者のニーズ満たすための、構造化された技術ドキュメントを作成するために、

各タイプのドキュメントを、明確で、簡潔で、わかりやすく記述するための

体系的なアプローチです。

また、ドキュメントを書く方にも、

どこに配置すべきドキュメントであるかが明確になるので、

迷わずに、ドキュメントを書くことができ、

自分がどの種類のドキュメントを書こうとしているかを考えながら、

ドキュメントを書くことで

ユーザにとって非常にわかりやすいドキュメントを書くことができます。

また、学習コンテンツとリファレンスを分離することで、

初心者と専門家の両方に効果的に役立ちます。

このようにDiataxis は、

ドキュメント作成のコンテンツの問題 (何を書くか) だけでなく、

スタイル(どのように書くか) や

アーキテクチャ(どのように整理するか) も解決する指針を与えてくれます。

先程の著者の経歴からも、明白ですが、

Canonicalで採用されています。

gihyo.jp

また、Cloudflareの開発ドキュメントなどでも利用されているとのことです。

developers.cloudflare.com

2024-08-16

SWOT分析の基礎と進め方

SWOT分析による経営改善計画書作成マニュアル

目次
はじめに
一般的なSWOT分析の進め方
SWOT分析の各項目と例
- S: Strength (強み)
- W: Weakness (弱み)
- O: Opportunities (機会)
- T: Threats (脅威)
クロスSWOT分析の各項目
- SO戦略 (強み × 機会)
- ST戦略 (強み × 脅威)
- WO戦略 (弱み × 機会)
- WT戦略 (弱み × 脅威)
参考資料
MyEnigma Supporters

はじめに

企業の現状を分析し、経営戦略やマーケティング戦略に対して、

今後力をいれるべき部分を明確するための分析方法として

SWOT分析があります。

ja.wikipedia.org

今回は、このSWOT分析の一般的な進め方などをまとめておきたいと思います。

2024-08-10

わかりやすいソフトウェアドキュメントのためのC4モデル

ソフトウェアアーキテクチャの基礎 ―エンジニアリングに基づく体系的アプローチ

はじめに

ソフトウェアの図を書くときに、

いつも抽象度をどのようにすればいいか、

悩むことがあるのですが、色々調べていたら、

C4モデルという考え方があることを知ったので、

そちらを調べたときのメモです。

2024-04-27

自動化システム開発のための要件定義入門

はじめよう! 要件定義 ~ビギナーからベテランまで

目次
はじめに
要望、要求、要件の違い
要件定義をするために準備すべきもの
- 1. プロジェクトやシステムの名称
- 2. 5W1Hに基づくシステム概要
- 3. ユースケース図
- 4. モジュール図
- 5. 基幹技術リスト
- 6. 要求リストを作る
- 7. ユーザーシナリオをつくる
- 8. UI遷移図を作る
- 9. レポート(帳簿)機能についての要求をまとめる
- 10. エンティティモデルを作る
- 11. ワークセットリストを作る
- 12. 非機能要件の検討をする
- 13. 要件リストの作成
要件定義を進め方
参考資料
MyEnigma Supporters

はじめに

ロボットなどを使って、

自動化システムを開発する人向けの

要件定義の方法や、言葉の定義、作成物のリストなどをまとめておきます。

2023-06-26

SciPy 1.11.0がリリースされました

Python プログラミング - NumPy SciPy ソフトウェアプログラマーコーダーパーカー

はじめに

本日、

自分がコア開発者のメンバーとして参加している

SciPyの新しいバージョン1.11.0がリリースされました🎉

github.com

今回も、1.11.0の新機能や特徴を、

連続ツイートでまとめてみたので、

そちらを、あとから参照しやすいように

記事としてまとめておきます。

過去のバージョンの記事は下記の通りです。

myenigma.hatenablog.com

2023-06-04

REST APIの仕様やドキュメントをテキストベースのファイルで記述できるOpenAPI(Swagger)入門

Designing APIs with Swagger and OpenAPI

目次
はじめに
Open APIの特徴
- 1. YAMLやJSONなどのテキストファイルで仕様を記述できる。
- 2. OpenAPIの仕様データから、仕様書を自動生成できる。
- 3. OpenAPIの仕様データから、APIのクライアントやサーバのコードを自動生成できる
Open APIの仕様の書き方
シングルHTMLファイルのAPIドキュメントを生成する
参考資料
MyEnigma Supporters