From a5365838906af9ef97bfd6b2a68025848cf80044 Mon Sep 17 00:00:00 2001 From: webron Date: Sun, 23 Mar 2014 13:14:41 +0200 Subject: [PATCH] Update README.md --- README.md | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 2e65bb94..465d5389 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,20 @@ -Swagger UI -========== +# Swagger UI -Swagger UI is part of [Swagger](http://swagger.wordnik.com/) project. The Swagger project allows you to produce, visualize and consume your OWN RESTful services. No proxy or 3rd party services required. Do it your own way. + +Swagger UI is part of Swagger project. The Swagger project allows you to produce, visualize and consume your OWN RESTful services. No proxy or 3rd party services required. Do it your own way. Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically -generate beautiful documentation and sandbox from a [Swagger-compliant](https://github.com/wordnik/swagger-core/wiki) API. Because Swagger UI has no dependencies, you can host it in any server environment, or on your local machine. +generate beautiful documentation and sandbox from a Swagger-compliant API. Because Swagger UI has no dependencies, you can host it in any server environment, or on your local machine. -How to Use It -------------- +## What's Swagger? + +The goal of Swagger is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined via Swagger, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interfaces have done for lower-level programming, Swager removes the guesswork in calling the service. + + +Check out [Swagger-Spec](https://github.com/wordnik/swagger-spec) for additional information about the Swagger project, including additional libraries with support for other languages and more. + + +## How to Use It ### Download You can use the swagger-ui code AS-IS! No need to build or recompile--just clone this repo and use the pre-built files in the `dist` folder. If you like swagger-ui as-is, stop here. @@ -85,8 +92,7 @@ window.authorizations.add("key", new ApiKeyAuthorization("Authorization", "XXXX" Note! You can pass multiple header params on a single request, just use unique names for them (`key` is used in the above example). -How to Improve It ------------------ +## How to Improve It Create your own fork of [wordnik/swagger-ui](https://github.com/wordnik/swagger-ui) @@ -94,8 +100,7 @@ To share your changes, [submit a pull request](https://github.com/wordnik/swagge Since the javascript files are compiled from coffeescript, please submit changes in the *.coffee files! We have to reject changes only in the .js files as they will be lost on each build of the ui. -License -------- +## License Copyright 2011-2013 Wordnik, Inc.