ドキュメントを書くときの「メンタルモデルの原則」 - クックパッド開発者ブログ
こんにちは。クリエイション開発部の丸山@h13i32maruです。 みなさんドキュメント書いてますか？私はドキュメントを書くのは結構好きです。最近もプライベートで開発しているJasperというGitHub用Issueリーダーのユーザ向けドキュメント（マニュアル）を書きました。でも良いドキュメントを書くのって難しいですよね。 そこで、本記事では「ツールやライブラリなどを対象にしたユーザ向けドキュメント」を書くときに私が考える原則を紹介します。ちなみに私はテクニカルライティングの専門家ではなく、普通のソフトウェアエンジニアです。そのあたりはいい感じに汲み取っていただけると🙏 🕵️メンタルモデルの原則 良いドキュメントとはどのようなものなのでしょうか？私は「そのツールやライブラリに対して読者がメンタルモデルを構築できる」のが良いドキュメントだと考えています。これを「メンタルモデルの原則」と呼
爆速の漫画ビューアへの挑戦｜深津 貴之 (fladdict)
4月にちょっと暇があり、「そうだ！ TypeScriptを勉強しよう」と、勢いで漫画ビューアを作ってみました。仕事でコード書くの4年ぶり。 最初は日曜プロジェクトの習作だったのですが…途中から「おっしゃー、見開きも対応したるで！」と、どんどんテンションがアップ。 気がついたら最終的に案件化され、noteのエンジニアチームのガチのサポートが入り…なんだかんだで、正式リリースされました！ そして一号案件が、なんとあのキャプテン翼です。光栄のいたり！ 漫画ビューワー世界最速計画僕はそこそこ漫画を読むほうで、昔はジャンプ、マガジン、サンデー、ヤングジャンプ全購読、1日1回漫画喫茶にかよい、Kindleにも漫画が3600冊ぐらい。漫画アプリと大手出版社のWEB漫画も、かなり巡回してました。 でも悲しいかな、世の漫画ビューアがほとんどが重い。どれもモッサリしており、パラパラ見るときなどは、かなりストレ
TypeScript + Vue.jsでのフロントエンド開発 - razokulover publog
最近webアプリ(RailsのviewでVue.jsを使ってる感じの部分)をフロントエンドだけ切り離してリライトする業務をやった。 他の業務と並行で進め、実装からリリースまでの期間は大体営業日換算で2週間ちょいくらい。 バックエンドのAPIなどはすでに開発済みのものを使えたので純粋にフロントエンドのみ。 途中、既存の動いてるアプリへ機能追加などされていたので都度追従していく作業もやった。 そもそもリライトすることを決めたのは元のアプリが歴史的な経緯などあり、トランスパイルできる環境に無く、加えてAndroid4.2以降のwebブラウザに対応する必要があったため。素手でES5を書き続けるのは規模が大きくなっていくとだいぶ辛いしここらでちゃんと整えましょうということで重い腰をあげたという感じ。 フロントエンドライブラリとしてはVue.jsに元々は慣れてたこともあり、Vue.jsを利用。この夏に
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
