ただの感想です。 Community-Driven Tools にあるものから以下を試してみました。 spectacle swagger2markup swagger-codegen redoc redoc-cli swagger-ui bootprint-openapi 一通り試した結果 redoc-cli が速度と見た目を両立していて、個人的にはこれを使うのが一番良いのではと思います。動的に作られる swagger.yml, swagger.json を読みたいなら redoc ですかねぇ。 spectacle URL: https://github.com/sourcey/spectacle Star: 648 Demo: http://cheesestore.github.io/ 対応バージョン: OpenAPI 2.0 方式: 静的HTML 見た目: そこそこ レスポンスの定義:
We explored free and open-source API documentation solutions, and compiled the results of our research in this post. Definitions An Application Programming Interface (API) is a set of clearly defined methods of communication between various software components. Organizations share their APIs so that developers can build applications that use the services of their software. API documentation descri
OpenAPI Specification Version 3.1.0 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 RFC2119 RFC8174 when, and only when, they appear in all capitals, as shown here. This document is licensed under The Apache License, Version 2.0. Introduc
これまで、python.jpではPythonの日本語ドキュメントを公開してきたが、この度、ドキュメントのホスティングを終了し、docs.python.org へのリダイレクトのみをおこなうようになった。 www.python.jp 実に喜ばしいことである。これまで、日本語ドキュメントは python.jp においてある私家版でしかなかったが、python.orgで公開されることで、一定の公式っぽさを得ることができる。 また、python.jpは私が一人でほそぼそと、さくらインターネットの一番安いVPSで管理運用してきた。しかし、これからはPython本家の運用チームできっちり運用していただけるのである。 別に難しいことをしていたわけではないが、python.jp運営のプレッシャーはちょっとしたものだった。ここ近年のPythonブームも、私がちょっとしくじってドキュメントを参照できなくなる、
システム管理者のガイド I. システムの基本設定 Expand section "I. システムの基本設定" Collapse section "I. システムの基本設定" 1. はじめに Expand section "1. はじめに" Collapse section "1. はじめに" 1.1. 環境の基本設定 Expand section "1.1. 環境の基本設定" Collapse section "1.1. 環境の基本設定" 1.1.1. 日付と時刻の設定について 1.1.2. システムロケールの設定について 1.1.3. キーボードレイアウトの設定 1.2. ネットワークアクセスの設定および検査 Expand section "1.2. ネットワークアクセスの設定および検査" Collapse section "1.2. ネットワークアクセスの設定および検査" 1.2.1.
Welcome to Fedora 20 (Heisenbug)! [ OK ] Reached target Remote File Systems. [ OK ] Listening on Delayed Shutdown Socket. [ OK ] Listening on /dev/initctl Compatibility Named Pipe. [ OK ] Reached target Paths. [ OK ] Reached target Encrypted Volumes. [ OK ] Listening on Journal Socket. Mounting Huge Pages File System... Mounting POSIX Message Queue File System... Mounting Debug File System... Star
少しプログラミングを覚えてきた初学者が、さらに力をつけるために必要なのが公式ドキュメントを読むことだと思います。 公式ドキュメントには、日本語の記事には書かれていないような詳細な説明や、APIの使用方法、そしてリリースノートなど、実装には不可欠な情報が掲載されています。 しかし、公式ドキュメントが上手く読めずにつまづく人も多いのではないでしょうか?慣れていない人にとっては、技術について書かれたドキュメントを読むのは難しいものです。 この記事では、つまづいてしまう人が少しでも減るように、公式ドキュメントが読めない原因と対策をいくつか書いていきます。 公式ドキュメントとは この記事で言及している「公式ドキュメント」は、フレームワークやライブラリ、言語について、その公式組織が出している文書のことです。 具体的にはこのへん。 どうして公式ドキュメントが読めないのか 原因1. 公式ドキュメントを読む
AWS サポートでは、お客様の課題の解決を効率的かつ迅速に行いたいと常に考えています。本ページでは、お客様が技術的なご質問をサポートケースに起票いただく際に、早期解決に役立つポイントをまとめました。例文も掲載していますのでぜひご参照ください。 なお、サポート全般についての一般的な情報は、AWS サポートをご参照ください。 サポートレベル毎の技術サポートへのアクセスについては、AWS サポートのプラン比較をご参照ください。 基本情報の入力について サービス/カテゴリー お問い合わせ内容に最も近い項目をご選択いただくことで、適切な回答が早期に得られる可能性が高まります。 お問い合わせ言語 日本語を選択します。英語での技術支援をご希望の場合には English を選択します。 連絡方法 多くの場合、Web を推奨します。連絡方法の詳細については、連絡方法(Web、電話、Chat)の選択についてを
理由 短期的に注目を集めない記事は無価値だという勘違い 人間には承認欲求を刺激すると知能が下がるバグがある 以下の機能を実装しないようにしている #Scrapboxの哲学 いいねボタンが無い SNS拡散ボタンが無い projectをまたがったユーザーランキング・記事ランキング・注目記事の様な機能が無い 公開projectであっても、外部からリンクが無ければGoogleにインデックスされない project内のどこかのページ、またはページリストにリンクがあればインデックスされる そこからGoogle botが巡回している様だ 各projectのページリスト画面には「リストです」というmeta tagを付けてある そこをクロールの起点にするはず。多分。 実際、この/shokaiにページを作成した場合 特にtweet等せず、何もしなくても数時間後にはGoogleで検索できるようになっている 既に
Sphinx Themes Gallery Curated and maintained by @pradyunsg and @shirou. Browse themes → GitHub Alabaster default click image to see more Read the Docs click image to see more Furo click image to see more Book click image to see more PyData click image to see more Press click image to see more Piccolo click image to see more Insegel click image to see more Insipid click image to see more Material c
年末カウントダウン Sphinx 連載、第3弾です。 一切下準備をせずに連載を始めたので、早くも息切れをしています。 だれかと約束をしたわけでもないのに急にアドベントカレンダー的なものを始めるのは、なんだか死に急いでいる気がしてきました。 今回は、今年から Sphinx の利用者に加わったある大型プロジェクトについて紹介しましょう。 そのプロジェクトとは、世界最大級の OSS のひとつである Linux カーネルです。 現在の Linux カーネルドキュメント 今年開催された LinuxCon Japan 2016 で Linux カーネルのドキュメントに Sphinx を使うという発表がありました。 Linus Torvalds氏が登壇、「約10週間のリリースサイクルは続く」 - クラウド Watch それから約 5ヶ月。現在はどうなっているのか見てみましょう。 Linux カーネルのド
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く