Claude3にプロジェクト全体をぶち込むためのプロジェクトの構造とファイル内容を自動でまとめるPythonスクリプト

2024/03/15 5 users Pythonスクリプト Claude3 構造 プロジェクト

はじめに Claude3Opusはものすごい能力で、手動で作成するのは面倒なプロジェクトのドキュメンテーションなどを一撃で生成してくれます。 しかし、プロジェクト全体の内容をWebのCladeには投入できないし、ファイルを１個ずつコピペするのもかなり時間を要します。 頼みのCursorもClaudeは対応していないので@Codebase機... 続きを読む

最新の Google Gemma モデルを MLX を使ってローカルでファインチューニング｜alexweberk

2024/02/25 26 users ファインチューニング 経緯 Apple Silicon 手順

今回は、最新の Google Gemma モデルを Apple Silicon に最適化されたライブラリ MLX を使ってローカルで実行したり、ファインチューニングしてみましたのでその手順を紹介します。 MLX 関連の情報はドキュメンテーションが分かりづらいものも多かったので色々試した経緯も共有しながら少しでも何かの参考になれば幸いで... 続きを読む

Vitestでドキュメンテーションテストする

2023/09/13 19 users Vitest

ドキュメンテーションテストをご存知でしょうか。 ドキュメンテーションテストとは、ドキュメントに記載されたコードを実行し、その結果が期待通りであるかを検証するテストのことです。 これにより、ドキュメントの内容が常に最新の状態であることを保証することができます。 Rustでは公式がrustdocというツールを提供... 続きを読む

【汎用ソフトスキル】ドキュメンテーションの続け方

2022/03/29 227 users 続け方

この記事の目的 最近「良いドキュメントが作れているな」と思う機会が増えてきたので、その知見をアウトプットしたくなった。 想定読者 今所属してる組織(会社/プロジェクトなど)のドキュメントがイマイチで悩んでいる人 そもそもドキュメントが無い組織に所属していてつらい思いをしている人 「ドキュメントを作れ」と... 続きを読む

継続的ドキュメンテーション: Github DiscussionsとADRのすすめ - LIFULL Creators Blog

2021/09/11 137 users ADR GitHub Discussions

こんにちは。テクノロジー本部のyoshikawaです。好きなW3C Recommendation は RDF 1.1 Concepts and Abstract Syntax です。 会議やチャットでのやり取りの決定事項・議事録、アプリケーションや機能の設計書・仕様書、READMEなどなど... LIFULLの開発現場においては、ソースコード以外にもこのように様々な文書の管理・... 続きを読む

プログラマーがドキュメントを書かない理由 - ITnews

2021/06/03 495 users ITnews medium トキ プログラマー ドキュメント

この記事は、著者の許可を得て配信しています。 Why programmers don’t write documentation 最近ではずっとコードのドキュメンテーションに関連した記事を書いていたので、当然、私のMediumのおすすめ記事には「開発者がドキュメントを書かない本当の理由」という記事が表示されるようになりました。この記事では、ドキ... 続きを読む

ピクシブでのNotionのつかいかた - pixiv inside

2021/05/20 20 users Notion ピクシブ GETA pixiv inside

こんにちは、pixivのリクエスト機能を開発するチーム（以下、リクエストチーム）でプロダクトマネージャーをしているgeta6です。 ピクシブでは、社内ドキュメンテーションツールとしてNotionを採用しています。Notionでうまいことドキュメンテーションが機能し、継続できるよう、使い方やルールを各メンバー・各チームみ... 続きを読む

社内のドキュメンテーションの取り組みと、Kitenのご紹介 - ペパボテックブログ

2021/03/18 11 users ペパボ june29 ペパボテックブログ 休日 人々

はじめに 技術部の @june29 と申します。最近の趣味は「お散歩」で、よく晴れた休日には妻といっしょに2時間くらい歩き回ったりしています。この記事では、わたしが2020年から力を入れて取り組んでいる社内におけるドキュメンテーションの活動の一部を紹介したいと思います。 問題意識 もともと、ペパボで働く人々には「... 続きを読む

リモートワークのいま学びたい、GitLab Handbookと徹底した文書化への狂気 - Qiita

2021/03/01 259 users Qiita Problem リモートワーク GitLab 狂気

Help us understand the problem. What is going on with this article? 1200人以上の全社員がリモートワーク。GitLabが公開する「リモートワークマニフェスト」は何を教えているか？ スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ その コメント GitLab Handbookで面白かったもの@コ... 続きを読む

GoogleやMicrosoftなどIT大手連合が「Open Web Docs」を発表 - GIGAZINE

2021/01/26 12 users GIGAZINE 下火 Mozilla Microsoft

GoogleやMicrosoftらで構成される大手IT企業連合が2021年1月26日に、Web開発者向のオープンなドキュメンテーションを支援するプロジェクト「Open Web Docs」の設立を発表しました。Mozillaも参加するこのプロジェクトは、Mozillaの不振により下火となっていたMDN Web Docsの空白を埋めるものになると期待されています。 ... 続きを読む

Oh Shit, Git!?!

2020/11/12 425 users Git ニワトリ oh shit 事柄 ハマリ

Gitって難しい。簡単にぐちゃぐちゃの状態になっちゃうし、失敗を直す方法を知ろうとしたところでまじくそ不可能。Gitのドキュメンテーションって卵とニワトリの問題みたいなところがあって、ハマりから抜け出すために知ってないといけない事柄の名前をあらかじめ知っていないと、どうやって問題を解決したらいいのか検... 続きを読む

GitLab的ドキュメント文化を組織にインストールする（実践編:スタートアップMNTSQの事例）｜Anno Takahiro｜note

2020/03/27 29 users Anno Takahiro｜note ドキュメント文化

会社組織にドキュメント文化をインストールすることの有用性や、GitLabのような企業がどのようにドキュメントを運用しているかを、前回記事で書いた（スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ）。今回は、私のいるスタートアップのMNTSQ（モンテスキュー、と読みます）でどのよ... 続きを読む

スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro｜note

2020/02/14 265 users スゲー GitLab Handbook 口頭 スケール 組織

ドキュメント文化は健全な組織のスケールのために必要　組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケー... 続きを読む

アメリカ空軍のドローンのドキュメンテーションがダークウェブで200ドルで売られていた | TechCrunch Japan

2018/07/12 13 users ダークウェブ ドローン アメリカ空軍 200ドル

クックパッドが食品ECビジネスに参入、街のお店の“こだわり食材”をアプリで買える「クックパッドマート」発表 続きを読む

Googleが社内のドキュメンテーションスタイルガイドを公開 | TechCrunch Japan

2017/09/08 636 users TechCrunch JAPAN Google 社内 公開

ドキュメンテーションは往々にして、後（あと）からの付け足しだ。オープンソースのプロジェクトではとくにそれが多い。そのため新しい人が後日そのプロジェクト参加しづらくなったり、ときにはヘタなドキュメンテーションのせいでコードがかえってわかりづらくなることもある。そこでGoogleは、デベロッパーがもっと良いドキュメンテーションを書けるために、同社の developer-documentation st... 続きを読む

オラクル、API開発スタートアップのApiaryを買収 - THE BRIDGE（ザ・ブリッジ）

2017/01/20 9 users Apiary オラクル Oracle OpenWorld

上: サンフランシスコの2016 Oracle OpenWorldにて Image Credit: Jordan Novet/VentureBeat オラクルは、開発者がAPIの設計やドキュメンテーションの作成する際の支援をするスタートアップ Apiary を買収する予定であることを発表した。買収額などの詳細は、非公開である。 2011年にサンフランシスコで創業したApiaryはこれまで800万ド... 続きを読む

2016/09/15 141 users angular バグ修正 正式リリース後 解説 予定

どうも、らこです。 ついに Angular 2.0.0が正式リリースされました ！めでたい！！ 今回はRC.7も含めた変更点の解説に加えて、正式リリース後のAngularの予定についても紹介します。 RC.6からの変更点 RC.7、2.0.0ともに、ほとんどがバグ修正とドキュメンテーションの追加で、破壊的な変更はRC.7にひとつあるだけです。 2.0.0-RC.7 2.0.0 破壊的変更 ...M... 続きを読む

Elixirだ 第6回

2015/07/02 80 users Phoenix mix タスク Inc Elixir勉強会

Transcript 1. 第6回 - Phoenixだ - GMO Pepabo, Inc. Joe Honzawa 2015/6/25 Elixir勉強会 Elixirだ 2. 前回やったこと > Mix > ドキュメンテーション > タスクを作ろう > Dialyzerで型チェック 3. 今回の内容 > Phoenixをちょっと飛ばす > インストールとプロジェクト作成 > ファイルを眺める... 続きを読む

Microsoftが企業のDevOps的実践を支援するツールとドキュメンテーション（eブック）をローンチ | TechCrunch Japan

2015/05/29 18 users デベロッパ ローンチ 知見 Microsoft 分野

Microsoftが今日、企業のデベロッパやITスタッフ、あるいは開発専門のデベロッパショップによる、DevOps的実践を支援する新しいプロジェクトを発表した。そのひとつは、開発実践の改良策を提案する自己評価ツール、もうひとつは、この分野におけるMicrosoft自身の過去数年間の知見を綴ったeブックだ。 MicrosoftのSam Guckenheimerがこう語る: “クラウド上のサービスを何... 続きを読む

良質なAPIドキュメンテーションと共にAPI利用者のためのデベロッパハブも提供するReadMe - TechCrunch

2015/03/14 94 users README TechCrunch デベロッパ API 企業

Y Combinatorで孵化したReadMeは、デベロッパ向けにAPIを提供している企業が、APIの良質なドキュメンテーションを容易に作れるようにしてくれる。 今はほとんどのサービスがAPIを公開しているから、それらを利用すれば自分が作るアプリケーションやサービスに高度な機能を簡単に実装できる。でも、APIをデベロッパにぜひ使っていただきたい、と願っている企業から見ると、そこにはデベロッパたちの... 続きを読む

ドキュメント用IPアドレスとドメイン | ツチノコブログ

2014/08/05 52 users ツチノコブログ ドメイン example.com ドメイン名

こんにちは 焼き直し的なネタですが、お恥ずかしながら私は知らなかったので共有します。 ドキュメント用にIPアドレスとドメインが予約されているって話です。 RFC2606：ドメインについて ドキュメント用に予約されているドメインは example.com example.net example.org ※これらのドメイン名はドキュメンテーションにおける例を提示するために利用する。このドメインは予約さ... 続きを読む

Infrastructure as Codeと 組織のドキュメンテーション ＋ Immutable Infrastructure事例

2014/03/15 71 users Immutable Infrast JAWS DAYS

Infrastructure as Codeと 組織のドキュメンテーション ＋ Immutable Infrastructure事例 Presentation Transcript Infrastructure as Codeと 組織のドキュメンテーション ＋ Immutable Infrastructure事例 2014/3/15 JAWS DAYS 2014 Immutable Infrast... 続きを読む

LGがWebOSをHPから買収！　今後はスマートTVのOSに。 : ギズモード・ジャパン

2013/02/25 46 users webOS ギズモード CNET 買収 特許

家電 LGがWebOSをHPから買収！　今後はスマートTVのOSに。 2013.02.25 20:10 LGはHPからWebOSの権利を買収したことを発表しました。契約にはWebOSに関連するコードの他に、ドキュメンテーション、従業員、特許などが含まれます。 CNET（元リンクは現在削除された模様）によれば、LGはWebOSをスマートTVのOSとして製品化するとのことです。LGは昨年からWebOS... 続きを読む

ゼロからはじめるAdobe Scout

2012/12/04 22 users Adobe Scout Scout 近日 手段 無償版

Adobe Scout（旧名モノクル）がいよいよリリースされました！ドキュメンテーションや使い方の記事は近日にリリースされますが、取り急ぎゼロから始める手段をこの場で解説します。 入手方法 アドビゲーム開発ツールのサイトを開く 右上のリンクでCreative Cloudメンバーシップにログインまたは登録（無償版でも良い） ログインするとScoutのダウンロードボタンが表示される プロファイリング開... 続きを読む

アジャイル開発におけるドキュメンテーションの実際(2) ―― ドキュメントの「必要最低限」の見つけ方｜Tech Village （テックビレッジ）　／　CQ出版株式会社

2012/11/02 44 users テックビレッジ ドキュメント 筆者 Tech Village

本連載では，アジャイル開発とウォータ・フォール開発の両方を経験している筆者が，アジャイル開発におけるドキュメントの位置づけや作成方法について解説する．今回は，開発において作成するべき「必要最低限のドキュメント」について考える．（編集部）   技術解説・連載「アジャイル開発におけるドキュメンテーションの実際」 バック・ナンバ 第1回　本当に必要ですか？ そのドキュメント   　前回は，アジャイル開発... 続きを読む