Swaggerの現状について投稿するのは久しぶりですが、最新情報をお伝えするのに遅すぎるということはありません！この数ヶ月間、私たちはいくつかの変更に取り組んできました。技術的な変更もあれば、ユーザー向けの変更もあります。この投稿では、重要度の順不同で、これらのアップデートの一部を説明します。
一般リリース
私たちはさまざまなプロジェクトで多数のリリースを行ってきましたが、そのすべてに目を通すのは意味がないかもしれません。しかし、ご存知ない方のために、すべてのリリースには、改善点、バグ修正、そして（できる限り避けていますが）破壊的な変更を詳述したリリースノートが付属しています。
GitHubの各プロジェクトには、「Releases」セクションがあります。例えば、https://github.com/swagger-api/swagger-ui/releasesです。
そこでは、すべてのノートとさまざまなバージョンを見つけることができます。新しいリリースを追跡するもう1つの良い方法は、プロジェクトを「watch」し、「Releases only」に設定することです。そうすることで、提出されるすべての問題やPRなしに、リリースが行われたときにのみ通知を受け取ることができます。
注目すべきリリース
私たちは定期的にバージョンをリリースしていますが、最近、新機能を提供するリリースもいくつか公開しました。すべての新しいプロジェクトは、OpenAPI 3.0をベースにしています！
バリデータバッジのバージョン2を正式にリリースしました。プロジェクトのインフラストラクチャは変更しましたが、APIは同じままで、Swagger/OpenAPI 2.0に加えてOpenAPI 3.0をサポートするという追加のボーナスがあります。
変更を反映するために、プロジェクトのマスターブランチは現在のバージョンを表し、v1ブランチには以前のバージョンのコピーがあります。
ホスト版の更新: 今日まで、ホスト版はhttps://online.swagger.io/validatorで提供されていました。今のところ、このURLは引き続きアクティブで、Validatorのv1を公開しています。新しいバージョンのValidatorはhttps://validator.swagger.ioでホストされており、Swagger UIの最新バージョンはこのURLを使用しています。古いURLを使用している方は、新しいURLに切り替えることを強くお勧めします。将来のある時点で、古いURLを新しいURLにリダイレクトするか、閉鎖する予定です。
問題の報告と貢献の提出: Validator Badgeプロジェクトは、Swagger Parserをカプセル化するシンプルなウェブサービスプロジェクトです。ウェブサービスに問題がある場合（例えば、APIが期待通りに機能しない場合）、https://github.com/swagger-api/validator-badgeで問題を報告してください。ただし、検証自体に問題がある場合は、https://github.com/swagger-api/swagger-parserで報告してください。不明な場合は心配いりません。好きな場所に問題を報告していただければ、必要に応じて転送します。
Converterは比較的新しいプロジェクトです。しばらくの間、舞台裏で開発していましたが、ついにオープンソースとしてリリースします。Validator Badgeと同様に、Swagger ConverterはSwagger Parserをラップするウェブサービスであり、古い定義ファイルをOpenAPI 3に変換する機能を提供します。ホスト版はhttps://converter.swagger.ioで公開されており、自分でビルドして実行することも、dockerイメージを使用することもできます。
問題の報告と貢献の提出: ウェブサービスに問題がある場合（例えば、APIが期待通りに機能しない場合）、https://github.com/swagger-api/swagger-converterで問題を報告してください。ただし、変換自体に問題がある場合は、https://github.com/swagger-api/swagger-parserで報告してください。繰り返しますが、不明な場合は、好きな場所に問題を報告していただければ、必要に応じて転送します。
え、何だって？！随分と長い道のりでしたが、Pet StoreのOpenAPI 3バージョンが遂にリリースされました！
現在、https://petstore3.swagger.ioでアクセスできます。将来的には、メインのhttps://petstore.swagger.ioをv3に置き換え、v2は別のURLで存続させる予定です。
Pet Store v3は、現在のところv2をOpenAPI 3に単純に移行したものです。しかし、現時点ではOAS3の機能を最大限に活用しているわけではありません。これを変更したいと考えており、皆様もご協力いただけます！
以前のPet Storeのバージョンがコードファーストのアプローチを採用していたのに対し、新しいPet Storeのバージョンではデザインファーストのアプローチを採用しています。これは、コード自体に精通していなくても、OpenAPI 3を知っていれば、プルリクエストを送信してPet Store自体の改善に貢献できることを意味します。ただし、Pet Storeは必ずしも優れたAPIデザインを示すことを意図しているわけではなく、むしろ仕様のさまざまな機能を網羅することを目的としていることを忘れないでください。
もう1つの変更点は、Pet Storeのソースコードが簡単に見つけられるようになったことです。 simply https://github.com/swagger-api/swagger-petstoreにアクセスしてください。ホストされている両方のバージョンがそこにあります（v3はmasterブランチ、v2はv2ブランチ）。
問題の報告と貢献の提出: 新しいリポジトリの登場により、アイデア、修正、変更の提出がこれまでになく簡単になりました。始めるには、https://github.com/swagger-api/swagger-petstoreにアクセスしてください。公開されているAPIへの提案のみを行いたい場合は、デザインファーストのアプローチの素晴らしさを示すhttps://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yamlに対してプルリクエストを送信するだけです。
新しい貢献ガイド
オープンソースプロジェクトの大きな利点の1つは、自分のニーズに基づいて貢献し、改善できることです。初心者でも経験豊富なユーザーでも、貢献する最善の方法について疑問があるかもしれません。
私たちは皆様の時間を大切にし、ご協力に感謝いたします。始めるのに役立つ情報をご紹介します。オープンソースへの貢献は、コードの貢献だけでなく、さまざまな形で行われることを忘れないでください。
私たちの貢献ガイドでは、質問への回答からテスト、コード変更まで、さまざまな協力方法を説明しています。
ご存知ない方のために説明すると、GitHubで新しいissueを開くと、右側のサイドパネルの下部に、プロジェクトのメンテナーが提供する一般的なリソースへのリンク（または複数）が表示されます。例えば、
貢献ガイドのソースはこちらで見つけることができます: https://github.com/swagger-api/.github/blob/master/CONTRIBUTING.md。
いつものように、フィードバックと貢献を歓迎しますが、これはすべてのプロジェクトの一般的なガイドであることを忘れないでください。