タグ APIドキュメント
人気順 5 users 50 users 100 users 500 users 1000 users流出した「Google検索」の社内文書、グーグルが本物と認める
Googleの検索部門から大量に漏えいしたとされるAPIドキュメントについて、Googleが本物であると認めたとThe Vergeが報じている。これは、SEOの専門家である米SparktoroのRand Fishkin氏、米iPullRankのMike King氏によって存在が明らかにされたもので、当初Googleはこの資料についてコメントを拒否していたという。 報道... 続きを読む
25000行超えのAPIドキュメントを分割した話
はじめに COUNTERWORKSバックエンドエンジニアの伊藤です。 この記事ではAPIドキュメント分割の知見を紹介します。 弊社では OpenAPI を使用したスキーマ駆動開発を採用しています。 1ファイルで管理していたところ、25000行を超える行数となり管理コストが高くなっていました。 そこで分割作業を実施したのですが、どの... 続きを読む
AWS版「GitHub Copilot」な「Amazon CodeWhisperer」が正式版に 個人ユーザーは無料、VSCodeに対応
参考:AWSも、プログラミングを機械学習で支援する「Amazon CodeWhisperer」プレビュー公開。コメントを書くとコードを提案 コメントや書きかけのコードからコードを自動生成 Amazon CodeWhispererは、オープンソースリポジトリ、Amazon内部リポジトリ、APIドキュメント、フォーラムなどから収集した数十億行のコードを... 続きを読む
documentationjs + add-text-to-markdownでREADME.mdのAPIリファレンスを自動更新 | Web Scratch
documentationjsはJSDocからドキュメントを生成できるツールで、ES2015以降のコードにも対応しています。 (TypeScriptは対応してないようです) 以前はMarkdownへの出力が難しかったのですが、いつのまにかdocumentation build -f mdでMarkdownでのAPIドキュメントが生成できるようになっていました。 これを使うことで、... 続きを読む
「mackerel-plugin-nature-remo」書いた - Masteries
2018 - 02 - 22 「mackerel-plugin-nature-remo」書いた 最近, いろいろあってNature Remoを購入しました. nature.global 購入してから知ったのですが, Nature Remoは温度と湿度が測定出来るようになっていて(湿度は10%刻みの概算値ですが), これもちょうど最近公開された APIドキュメント を見ていたところ, Nature ... 続きを読む
「mackerel-plugin-nature-remo」書いた - Masteries
2018 - 02 - 22 「mackerel-plugin-nature-remo」書いた 最近, いろいろあってNature Remoを購入しました. nature.global 購入してから知ったのですが, Nature Remoは温度と湿度が測定出来るようになっていて(湿度は10%刻みの概算値ですが), これもちょうど最近公開された APIドキュメント を見ていたところ, Nature ... 続きを読む
[TensorFlow] APIドキュメントを眺める -Tensor編- | Developers.IO
はじめに TensorFlow研究会 に先立ち、予習をしておこうと思い、まずは Githubリポジトリ のREADME.mdを試してみたあと、 APIドキュメント を眺めてみました。 まずはぱっと目についた Tensor クラス を一通り通読したのでまとめてみます。 Tensor について Tensor (Tensor クラスのインスタンス)は TensorFlow の名前の由来でもあり、数学で言... 続きを読む
Qiita API v2のJSON Schemaを公開しました - Qiita Blog
こんにちは、r7kamura です。 最近は主にイカとして活動しており、カラフルな墨を掛け合う日々を送っています。 さて、QiitaおよびQiita:Teamでは、Qiita API v2としてデータを操作するためのREST APIを公開しています。これまで開発者向けに APIドキュメント を提供していましたが、今回は主に機械向けのインターフェースとして、JSON Schemaで記述したREST ... 続きを読む
Jdoc - JSON SchemaからAPIドキュメントを生成 MOONGIFT
JSONがWeb APIのデータ送受信フォーマットとして活用されるようになると、受け取る側と発信する側でその内容が適切であるかどうか検証する手段が必要になります。それがJSON Schemaです。 2009年頃に登場したようですが、当時は面倒がってあまり使われてきませんでしたが、JSONの普及ともとに注目が集まっています。そんなJSON Schemaを開発者にも優しいフォーマットに変換してくれるの... 続きを読む
REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita
背景 APIドキュメントを書くのが楽になるツールまとめ - Qiita iodocsで便利なREST APIドキュメントを作成する - Qiita これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげなドキュメントツールを色々調べてたんだけど、最終的にapiary.ioが一番良さそうという結... 続きを読む
TypeScriptのAPIドキュメントをyuidocjsで自動生成 - 成らぬは人の為さぬなりけり
2013-06-22 TypeScriptのAPIドキュメントをyuidocjsで自動生成 TypeScript Node.js 現在、仕事でTypeScriptを使っていますが、 APIドキュメントが欲しくなってきて、 JavaDocとか、RDocとか、ScalaDocとか、みたいに 自動生成させたいなぁと思い、いろいろ試してみました。 試したツール jsdoc (npm) JsDoc Tool... 続きを読む
JSDoc Toolkit→JSDoc 3移行ガイド - Technology of DeNA
JSDoc Toolkit→JSDoc 3移行ガイド by 渋川よしき 2013/05/08 10:59 on JavaScript ツイート こんにちわ、DeNAサン・フランシスコの渋川と申します。エンジニアブログには初登場です。 JavaScriptのソースコードからAPIドキュメントを生成するツールには何種類かありますが、本語の書籍やウェブサイトでも情報が得られることもあって、JSDocの系... 続きを読む
各種サービスのAPI情報をまとめた『API for that』 | 100SHIKI
お、これは便利そう。 API for thatでは、各種サービスのAPI情報をまとめているようだ。 Dropbox、Tumblr、Github、などなどとの連携サービスを作るときに良いだろう。 もちろん自分で調べることもできるが、APIドキュメントはサイトの奥の方にあってうまく検索できないこともあるのでこうしてまとめられているとありがたい。 開発者だったら覚えておいても損はないですな。 API f... 続きを読む
数十兆円市場のテレコム関連市場に狙い:クラウド電話APIのTwilioが日本上陸、創業CEOに聞いた - @IT
巨大なテレコム市場の一角で破壊的イノベーションを起こしつつあるTwilio(トゥイリオ)が、いよいよ日本に上陸した。2012年10月に業務提携を発表していたKDDIウェブコミュニケーションズと米Twilioの2社は、2013年4月17日から日本国内でも“クラウド電話API”と彼らが呼ぶ「Twilio」の提供を開始すると発表した(プレスリリース)。APIドキュメントの日本語化も完了していて、今後はK... 続きを読む
多数の言語のAPIドキュメントを一元管理「DocHub」 - MOONGIFT|オープンソース・ソフトウェア紹介を軸としたITエンジニア、Webデザイナー向けブログ
プログラミングをある程度やっていると、解決法を探すのにAPIドキュメントを当たるのが一番早くなっていきます。そこで社内でも使えるAPIドキュメントサーバとしてDocHubを紹介します。 0 続きを読む
JavaScriptによる開発が大規模化したらドキュメントを生成「Dox」 | MOONGIFT | オープンソース・ソフトウェア紹介を中心としたITエンジニア/Webデザイナー向けブログ
DoxはJavaScript/node.js製のオープンソース・ソフトウェア。JavaScriptがWebアプリケーション構築の際のメイン言語として使われるようになっている。その結果起こっているのがJavaScriptのコードの大規模化だ。トップページ大規模になれば当然、複数人での開発体制になる。そうなれば情報の共有やコーディングスタイルの統一などが必須になる。その一端を担うのがAPIドキュメント... 続きを読む
最人気Ajaxフレームワーク最新版Prototype 1.5 - 待望のAPIドキュメントも (MYCOMジャーナル)
Sam Stephenson氏は18日(米国時間)、Prototype 1.5を公開したことを明らかにした。PrototypeはJavaScriptによる軽量Ajaxフレームワーク。Prototypeは2006年9月23日(米国時間)に公開された「Ajaxian.com 2006 Survey Results」の調査結果において、もっとも人気があるAjaxフレームワークとされており、注目のバージョ... 続きを読む