チームに無能がいなくなる『メンバー全員で公式ドキュメントを読みあわせる』に感銘をうけた話。 - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? これは、同じエンジニアである妻から聞いた話なのですが、彼女の案件で「メンバー全員で公式ドキュメントを読みあわせる」という取り組みがあったそうです。 で、この方法「チーム全体にとって大きなメリットがあるんじゃないか？」と思ったので、共有させていただきます。 「誰も知らない」から「みんな知ってる」に 私は開発職なので、めずらしいことなのかそうではないのか判断がつかないのですが、その案件では、導入対象の製品について詳しい知識を持っているメンバーが一人もいなかったというのです。 誰もその製品をさわったことがなく、とりあえず強そうなメンバーを入れ
コードファーストでOpenAPIを爆速で定義できるFastAPIを使おう！｜Tak
テックブログ担当させていただくことになりましたTakです。業務ではJavaのサーバーサイド実装が主なのですが個人的にはPythonが好きです。私の業務では使っていませんがPythonについての記事になります。 OpenAPIとは？REST APIを開発する際にAPI仕様書をOpenAPI Specificationで用意するのは一般的です。「OpenAPIとはなにか」が分からない場合はググってもらうとたくさん解説が見られるのでそちらをご覧ください。 簡単に言えば、「あるREST APIは、このようなパスで、このようなリクエストを受け付けてこのようなレスポンスを返すよ」というスキーマ定義です。 GraphQLのスキーマ定義についてはこの記事では書いてないです。 文章で書かれたAPIドキュメントは人間が読むだけのものになりますが、OpenAPIのスキーマ定義はツールに読み込ませて次のようなこと
Google Docs、Markdown形式でのドキュメントのエクスポート、インポートなど可能に
Googleは、Google Docsの新機能としてドキュメントをMarkdown形式でエクスポートする機能やMarkdown形式のファイルをドキュメントとして読み込む機能などを発表しました。 具体的には以下の4つの機能が利用可能になります。 Markdown形式のテキストをGoogle Docsのドキュメントに変換してペースト Google DocsのドキュメントをMarkdown形式のテキストとしてコピー Google DocsのドキュメントをMarkdown形式のテキストとしてエクスポート Markdown形式のテキストをGoogle Docsのドキュメントとしてインポート 例えば、Google DocsのドキュメントをMarkdown形式のテキストとしてエクスポートする場合には、下記の「ダウンロード」メニューからMarkdowsn形式を選択することになります（下記の画像は現時点での
ドキュメントをいい具合に残そうの会 - Qiita
最近、『エンジニアのためのドキュメントライティング』という本を読みました。 非常にためになる内容だったので、本書であがったいくつかのポイントを私なりにまとめてみました。 また、エンジニアにとってのドキュメントは種類が多く、それぞれのニーズとそれに合わせたフォーマットも違うため、 良いドキュメントとは何か？ を一概に述べることは難しいです。 個人的には、「ほぼ知識のない人が読んでも再現できる・解決できる」ということが大事なのではないかと思っています。 そこで、本記事ではドキュメントの範囲を少し絞って、想定される読者をエンジニア寄りに考えて書いています。ご了承ください。 目次 本記事では ドキュメントを作成する前 ドキュメントを作成する時 ドキュメントを作成した後 それぞれのタイミングにおけるポイントを挙げていきます。 📑 ドキュメント作成前のポイント フリクションログとは、あるユーザー1の
Getting Started — Luigi 2.8.13 documentation
Luigi is a Python (2.7, 3.6, 3.7 tested) package that helps you build complex pipelines of batch jobs. It handles dependency resolution, workflow management, visualization, handling failures, command line integration, and much more. Getting Started¶ Run pip install luigi to install the latest stable version from PyPI. Documentation for the latest release is hosted on readthedocs. Run pip install l
Migrate to Compose V2
OverviewGet Docker Docker Desktop Overview Install Docker Desktop Install on MacUnderstand permission requirements for MacInstall on WindowsUnderstand permission requirements for WindowsInstall on Linux Installation per Linux distro Install on UbuntuInstall on DebianInstall on FedoraInstall on ArchSign in Explore Docker Desktop OverviewExplore ContainersExplore ImagesExplore VolumesExplore BuildsR
破綻したドキュメント管理、増え過ぎたプロダクトバックログ… 「Jira」「Confluence」などの活用失敗から学ぶツール運用のコツ
Jira SoftwareやTrelloなどを中心としたPMが経験してきたプロダクト管理ツールの失敗や改善を語る「本当に使いこなせてる？プロダクト管理ツールの失敗&改善PMトーク【開発PM勉強会 vol.20】」。ここで株式会社ビズリーチの菊池氏が登壇。ドキュメント管理とプロダクトバックログの失敗から学ぶツール運用のコツについて紹介します。 菊池氏の自己紹介 菊池信太郎氏（以下、菊池）：ビズリーチの菊池から、10分枠で話をします。今日のテーマは「失敗から学ぶドキュメントとチケット運用のコツ」ということで、今まで経験したところで「こういうアンチパターンがあったよ」「こういう改善をしたよ」というようなところをお話しできればと思っています。 自己紹介を軽くすると、（私は）2018年からビズリーチで働いています。ビズリーチサービスを作っていて、プラットフォーム開発部の部長をしています。また、201
Androidアプリ開発でAPIのリファレンスを参照する方法【初心者向け】
Androidアプリ開発で【APIのリファレンス】を参照する方法を初心者向けに解説した記事です。「Androidデベロッパーサイト」で確認する方法と「Android Studio」で確認する方法の2つがあるので、1つずつ紹介していきます。 テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元：GMOリサーチ株式会社 調査期間：2021年8月12日～8月16日 調査対象：2020年8月以降にプログラミングスクールを受講した18～80歳の男女1,000名 調査手法：インターネット調査 Androidアプリを開発していると、使用しているAPIの引数や戻り値、対応しているAPIレベルなど、確認が必要な場合あります。 そこで、Androidアプ
pdb — The Python Debugger
pdb — The Python Debugger¶ Source code: Lib/pdb.py The module pdb defines an interactive source code debugger for Python programs. It supports setting (conditional) breakpoints and single stepping at the source line level, inspection of stack frames, source code listing, and evaluation of arbitrary Python code in the context of any stack frame. It also supports post-mortem debugging and can be cal
ITエンジニア向けのトレンド情報 | Forkwell Press （フォークウェルプレス）
アーカイブでは視聴者からのQ&Aを見ることができます ドキュメント文化を浸透させる方法 おすすめのドキュメント管理ツール ドキュメントがない状態での引き継ぎ 運用しやすいドキュメント構造とは 増えすぎたドキュメントの管理方法 ドキュメントを残さないシニアエンジニアへの対策 ドキュメントへの苦手意識を克服する方法 誰もドキュメントを読んでくれません 複数人でドキュメント管理するコツ 本記事のTopics 書籍の概要・構成 おすすめの書籍 読み手の理解 ドラフトの執筆 フィードバックの収集と組み込み ドキュメントの品質測定 日本語を学べる書籍 ドキュメントは開発側の生産性とユーザーの利便性を高めるもの。ドキュメントがなければ、ユーザーに使われる機会が確実に減ります。開発者がいかにすばらしいプロダクトを作ろうが、ドキュメントの欠如がその価値を奪うのです。 本書は、経験に長けた執筆者たちがドキュメ
netmiko/PLATFORMS.md at develop · ktbyers/netmiko
A10 Accedian Alaxala AX2600S and AX3600S Allied Telesis AlliedWare Plus Aruba OS (Wireless Controllers/WAPs) Aruba AOS-CX Brocade Fabric OS C-DOT CROS Ciena SAOS Citrix Netscaler Cisco APIC (Linux) Cisco Telepresence Cisco Viptela Check Point GAiA Coriant Dell OS6 Dell EMC Isilon Digi TransPort Routers Eltex Enterasys Endace Extreme EXOS Extreme Wing Extreme SLX (Brocade) F5 TMSH F5 Linux Fortinet
Python for Network Engineers - Netmiko Library
Since late 2014, I have been working on an open-source Python library that simplifies SSH management to network devices. The library is based on the Paramiko SSH library and is named Netmiko. You can find the library at https://github.com/ktbyers/netmiko and the latest released version of the software can be installed using pip. Library Purpose The purposes of this library are the following: Succe
OpenAI API ドキュメント 日本語訳｜#1 GET STARTED 前編｜ゑぐみかるちゃあ
OpenAI API ドキュメントの日本語訳をこちらでまとめます。文字量の多いドキュメントなので、セクションごとに記事を分割しています。 今回は「GET STARTED 」のセクションからIntroduction と Quickstart を抜粋した前編です。 基本 DeepLで翻訳して、気になるところだけ書き換えています(ほぼ気になるところがないのが、DeepLのすごいところ)。原文との突き合わせができるようにはじめに原文を入れてますので、間違いなど見つけられましたら、ぜひご指摘ください。ご指摘箇所は随時反映させていただきます。 原文のリンクが有効になってますので、それぞれ必要な場合は原文リンクの方を参照ください。 Introduction｜はじめに Overview｜概要The OpenAI API can be applied to virtually any task that i
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
運用エンジニアのための AWSドキュメントの歩き方・まとめ方 / 20240822-jawsug-tokyo-aws-documents
AWS IoT Core endpoints and quotas - AWS General Reference
GitHub - 1f408/cats_dogs: CAT'S DOCument System
MACRO Help Index
[python] クラス図を自動生成する - Qiita![[python] クラス図を自動生成する - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/edc509848059354f523f908f79ef494262af6918/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JTVCcHl0aG9uJTVEJTIwJUUzJTgyJUFGJUUzJTgzJUE5JUUzJTgyJUI5JUU1JTlCJUIzJUUzJTgyJTkyJUU4JTg3JUFBJUU1JThCJTk1JUU3JTk0JTlGJUU2JTg4JTkwJUUzJTgxJTk5JUUzJTgyJThCJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMxRTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz00NzRiMmNjYWM4NDhmYzJjNGE1NTg5NDg4NDU5NWE3NQ%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBrZW5pY2hpLWhhbWFndWNoaSZ0eHQtY29sb3I9JTIzMUUyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9MGZjYmM1ODA1NzQxZjQ3MDc1OWY3MGRhNWQzZWZhOTY%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D2266dc1d75bcb3835bf6036ced60a165)
日本語ネイティブのユーザーが英語ドキュメントを書く際に指針となるガイドが無料公開中【やじうまWatch】
IT英語スタイルガイド | IT英語スタイルガイド
