サバイバルTypeScriptのGPTsを作成・公開しました
サバイバルTypeScriptは有志で執筆を進めているTypeScriptのOSSドキュメントです。 今回、サバイバルTypeScriptのドキュメントをベースにTypeScriptに関する質問に答えてくれるGPTsを作成・公開しました✨ この記事ではGPTs公開の背景や作成手順、現状の課題などをまとめています。 GPTs公開の背景 LLMによるドキュメント検索は近い将来（既に？）一般的になると思い、サバイバルTypeScriptでも実験的にチャットボットでの情報アクセスを作成・公開しました。 ドキュメントの情報アクセスの課題 ドキュメントが多くなると、目次やサイトマップ、サイト内検索だけでは必要な情報にアクセスするのが困難になる。 チャットボットのメリット 雑な質問でも意図を汲んで、知りたい情報にアクセスしやすい 内容を要約して説明してくれるので、手軽に情報にアクセスできる 回答の信頼性
Code Tour を使ってじっくり確実にコードを読む
日々のタスクに忙殺されていると、ついつい既存コードを流し読みして、ざっと動くコードを書いてしまいたくなります。 一発でうまく動けば短期的にはいいのですが、長期的にはコードの理解が追いつかなったり、一発でうまく動かなかった場合にかえって時間がかかってしまいます。 VSCode の拡張機能である Code Tour を使うと、コード上にメモを残しながら読み進めることができるので、既存のコードを読む際に便利です。 Code Tour とは VSCode の拡張機能で、コード上にメモを残しつつ、そのメモをたどることができるツールです。 使い方 ツアーを始める コマンドパレットから「Code Tour: Record Tour」を選択すると、ツアーの記録モードになります。 ツアーの名前 どのソースに紐づけるか（紐付けなし、ブランチ、タグ） を選択すると、リポジトリ直下に .tours/${指定したツ
E2Eテストの運用を属人化しないための3つの取り組み - ANDPAD Tech Blog
はじめに こんにちは。QCの佐藤です。 月日が経つのは早いもので、QCメンバーも増え、多くのメンバーがブログを書いてくださっており嬉しい限りです😊*1 ANDPADで韻を踏む - ANDPAD Tech Blog アンドパッドラップの作り方 - ANDPAD Tech Blog QAがGoで始めるテストデータ作成の自動化 - ANDPAD Tech Blog ANDPADのQualityControlを紹介します！2023 - ANDPAD Tech Blog 私がブログを書いたのはもう2年前...（徐々に間隔が長くなっている...） 今回は私の担当しているプロジェクトでの、E2Eテスト管理・運用方法についてお話します。 以下のような課題ってE2Eテストあるあるですよね (´;ω;｀) E2Eテストの運用が属人化してしまっている... むか～しに作ってからはただ回しているだけ... テス
ChatGPT で何が変わったか
2023 年 3 月時点で、自分の開発スタイルがどう変わったかを雑に書いておく。 どんなタイミングで何を聞いているか主に Go と TypeScript や W3C や IETF の仕様について聞く場合はほぼ ChatGPT Plus を利用している。間違いとかはどうせ公式ドキュメントを読めばいいので、正しさは求めておらず、きっかけを求めている。 最近では Cloudflare Workers 上で動く WebAuthn サーバーを実装しているが W3C の WebAuthn を開きつつも、ほぼ ChatGPT に相談しながら実装している。 TypeScript で Uint8Array から ArrayBuffer に変換する方法を聞いたり、証明書について聞いたりと色々。参考までにどんなことを聞いているかを紹介しておきたい。 WebAuthn で送られてくる署名の r と s がたまに
日本語版を公開 - 法律専門家のためのWebAssembly : ライセンス コンプライアンスにおける現在のパラメータを探る - The Linux Foundation
日本語版を公開 – 法律専門家のためのWebAssembly : ライセンス コンプライアンスにおける現在のパラメータを探る 本日、オープンソース ライセンスコンプライアンスの第一人者Armijn Hemel氏 (MSc, Tjaldur Software Governance Solutions) によるレポート「WebAssembly (Wasm) for Legal Professionals : Exploring Current Parameters in License Compliance」の日本語版「法律専門家のためのWebAssembly : ライセンス コンプライアンスにおける現在のパラメータを探る」が公開されました。 WebAssemblyは、現在注目を集めている技術です。インターネット上のWebAssemblyドキュメントは、主に開発者を対象としており、その使用方法
オンラインドキュメントと日本語全文検索
自社では Sphinx というドキュメントツールを利用しているのですが、残念ながらこれに付属している検索機能の日本語検索はかなり厳しいです。また残念ながら Sphinx 開発側も検索周りを改善するという予定は直近ではないようです。 そして検索というのはとても難しい技術なため自分のような素人では導入して「普通に期待する動作」をさせるまでの距離はとても遠いです。 ただ、なんとかして日本語全文検索を実現したいという思いはここ10 年くらいずっと思っていました。これは自社の Sphinx テーマを作ってくれている社員ともよく話をしていたのですが、どうしてもリソースをつぎ込めずにいました。 まとめ日本語検索に対応している Meilisearch を採用したドキュメントスクレイパーの実行は GItHub Actions (Self-hosted Runner) を採用した自社 Sphinx テーマの検
Dockerfile のベスト・プラクティス — Docker-docs-ja 19.03 ドキュメント
このドキュメントは、効率的なイメージ構築のために推奨するベストプラクティスを扱います。 Docker は Dockerfile に書かれた命令を読み込み、自動的にイメージを構築します。 Dockerfile はイメージを構築するために必要な全ての命令を、順番通りに記述したテキストファイルです。 Dockerfile は特定の書式と命令群に忠実であり、それらは Dockerfile リファレンス で確認できます。 Dockerfile の命令に相当する読み込み専用のレイヤによって、 Docker イメージは構成されます。それぞれのレイヤは直前のレイヤから変更した差分であり、これらのレイヤは積み重なっています。次の Dockerfile を見ましょう。 命令ごとに１つのレイヤを作成します。 FROM は ubuntu:18.04 の Docker イメージからレイヤを作成 COPY は現在のデ
Kazuho Oku on Twitter: "HTTP を使うサーバクライアントアプリ作ってる人が、HTTP 的にどうするのが正しいのかな、と迷った時、見るべきドキュメントは BCP56bis かな、という話をした。HTTP の仕様ではなく、どのように使うべきかを説明した文書… https://t.co/7ke9ePZtTn"
HTTP を使うサーバクライアントアプリ作ってる人が、HTTP 的にどうするのが正しいのかな、と迷った時、見るべきドキュメントは BCP56bis かな、という話をした。HTTP の仕様ではなく、どのように使うべきかを説明した文書… https://t.co/7ke9ePZtTn
ネットワーク図・システム構成図作成に使えるアイコン集 - Qiita
トポロジー図作成などに使ったりするアイコンは、結構サービス側で提供していたりする。 そう、よく目にするであろう、あのアイコンたちである。 リンクとともにまとめてみた。 Cloudサービス AWS AWSの公式アイコン集です。 2019/1/31からリリース2が公開されデザインが一新されました。PPT形式のドキュメントには、GroupsやIcons, Arrowsの使い方指南（すること、やってはいけないこと）が書かれています。このガイドにしたがって使いましょう。 また。この新しいバージョンの他に従来の旧バージョンも公開されています。 新バージョン 旧バージョン Google Cloud Platform 以前リンク切れていたのですがいつの間にか復活していました。アイコンが一新されたようです。 （ページには「図の例」があるよ、と言っているものの、2021/5/11現在まだ準備されていないようで
NHK『のぞき見ドキュメント #100カメ』がTwitter社に潜入→警察からの削除要請、2週に一度の新入社員入社、飲みニケーション重視などの実態が明らかに
NHKドキュメンタリー @nhk_docudocu 【27日夜】 #ツイッター 社の裏側に固定カメラ100台で潜入！身近なSNSの“中の人”たちって…？ 秘密オンパレードの現場 #100カメ 番組史上最大の壁が立ちはだかる。それでも浮かび上がる、意外な実態とは。 27日(月)夜10時50分から放送予定。[総合] #オードリー nhk.or.jp/docudocu/progr… 2020-01-26 10:00:12 リンク NHKドキュメンタリー - 【ストーリーズ】のぞき見ドキュメント １００カメ「ツイッター社」 NHKドキュメンタリー - 【ストーリーズ】のぞき見ドキュメント １００カメ「ツイッター社」 １００カメ「ツイッター社」をのぞき見！ 56
Vue.jsとNuxt.jsを使っていて、どっちのドキュメントを見ればいいんだ？ってなったときのために機能を整理する。
Vue.jsとNuxt.jsを使っていて、どっちのドキュメントを見ればいいんだ？ってなったときのために機能を整理する。 開発に慣れてきたら迷うことはないと思いますが、Vue.jsをさわるのが初めてでNuxt.jsを採用した場合、どっちのドキュメントを見ればよいかわからずに、さまよってしまう事があるかもしれません（自分がそうでした）。そんなときのための、長ったらしいメモです。 この記事を書いている時点では、Vue.jsが2.5、Nuxt.jsが1.2です。 ドキュメントの歩き方 まずはガイドで概要を把握して、細かいことが気になったらAPIをあたります。 Vue.jsでの開発がはじめてであれば、本格的に書き始める前に、スタイルガイドを見ておくと、手戻りが少なくなるかもしれません。 ガイド フレームワークの使い方がわかりやすく書かれています。 はじめにから順に読んでいって、大体こんなことができる
ウェブ開発者に朗報--MS、グーグル、Mozillaがブラウザ関連文書を1カ所に
印刷する メールで送る テキスト HTML 電子書籍 PDF ダウンロード テキスト 電子書籍 PDF クリップした記事をMyページから読むことができます MicrosoftとGoogle、Mozillaの各社は米国時間10月18日、自社のブラウザ関連ドキュメントを「MDN Web Docs」上に集積していくことで合意したと発表した。 これによりMDN Web Docsは、「Firefox」関連のWeb APIや情報をまとめたサイトという位置付けから、「Google Chrome」と「Microsoft Edge」、Firefoxに関連する情報の拠点という位置付けとなる。同サイトには、JavaScriptやCSS、HTMLのほか、さまざまなWeb APIに関するウェブ開発者向けの情報やチュートリアルが集積されている。 情報の拠点が1カ所に集約されることで、開発者はクロスブラウザアプリの開発
英語でサポートを求める時の Tips - Qiita
私は、サンフランシスコに住んでいたことがあって、インフラの勉強していたのですが、当時勢いで応募したインターンに受かり、その後エンジニアとして働いていました。日本人はもちろん一人で、プリセールスからJava のコーディング、テスト、サポート、ドキュメントまでの一連を日本語にローカライズする仕事をしていたのですが、その時の試行錯誤で（失敗もしくは成功から）学んだことをログしていきたいと思います。 当時はほんといろんな面で初心者・経験なしだったので、当たり前のことを書いていたらすみません、、、 当時のタスクの一つとして、QA がありました。仕様でない動作を見つけたら、バグ管理のシステムに入力し、担当の人に修正してもらい、修正を確認するというものです。 当時英語は問題なくできていたのですが、やはり「説明」となると急にハードルが上がりました。始めは、ほんと何にもQAに関する知識もなかったので、一生懸
新規アプリを作り始める前にチームで決めたこと | CyberAgent Developers Blog
こんにちは。 サイバーエージェント子会社の株式会社トルテでiOS開発してる@corin8823です。 2017年3月1日にiOSエンジニアのための勉強会、CA.swift #2を開催しました。 前回の勉強会の様子はこちらで確認できますCA.swift #1 レポート 登壇者として参加したのでその発表の内容 + αを記載したいと思います。 チームで新規アプリを作る際の参考になれば幸いです。 当日の資料はこちらです。 当日の資料 導入 昨年の2016年11月にマッチングアプリ開発のため、新しい子会社株式会社トルテが設立さました そこで新規サービスを開発しています。 そこで今回はそのサービスを開発するにあたり、チームのメンバーと本開発に入る前になにを決めたかをお話できればと思います。 今回は主に他の職種の技術者と決めたことに焦点をあてて話します。 サーバーサイドエンジニア サーバーサイドエンジニ
ESDocという(多分)モダンなドキュメンテーションツールの紹介 - maru source
こんにちは丸山@h13i32maruです。 僕は2015年からESDoc*1というJavaScript向けのドキュメンテーションツールを開発しています。 https://esdoc.org https://github.com/esdoc/esdoc Star 最初のリリースから2年、昨日ようやくv1.0をリリースできました🎉 いやー、ここまで長かったです。今ではRxJSやSketchAPIなど、様々なツールで使用されています。 この2年間、ESDocは2つのゴールを目指して開発してきました。 ドキュメントの作成・メンテナンスを快適にする（ドキュメントを書くの楽しい！という状態） ソフトウェアの使い方を簡単に理解できるドキュメントを作成する（ソースコード読まなくても大丈夫！という状態） この2つを満たすためにESDocは色々な機能を提供しています。 今日はそれらの機能の中でも(多分)モダ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Webドキュメント改善のためMozillaがMDNを一新する