<commit_before>doctype html
html(lang="en")
  head
    title An introduction to swagger
  body
    .reveal
      .slides
        section
          h2 An introduction to
          h1 swagger
          img(src=require("./assets/swagger_logo.png") style="background: none; border: none;")
          p
            i by <NAME>
        section
          h2 Motivation
          figure.fragment.fade-in
            img(src=require("./assets/motivation.jpg") style="height: 500px;")
            figcaption (by geek-and-poke.com)
        section
          h2 What is swagger?
          p.fragment
            | Swagger is a formal
            a(href="http://swagger.io/specification/")  specification
            |  surrounded by a large ecosystem of
            a(href="http://swagger.io/tools/")  tools
            |  for REST APIs.
        section
          section
            h1 Why swagger?
            p.fragment
              i.fa.fa-arrow-down.fa-3x
          section
            h2 Alternatives
            ul
              li.fragment RAML
              li.fragment API Blueprint
          section
            h2 Common goals
            ul
              li Easy to write
              li Comfortable to read
              li Documentation / Client / Server generation
              li Language agnostic
          section
            h2 What about WSDL 2.0?
            ul
              li.fragment Core concept SOAP not REST oriented
              li.fragment Sparse documentation
              li.fragment Limited community
              li.fragment Hard to read
              li.fragment Tedious to write
              li.fragment Limited REST specific tool chain
          section
            h2 Comparison
            table
              thead
                tr
                  th
                  th RAML
                  th API Blueprint
                  th Swagger
              tbody
                tr.fragment.highlight-current-blue
                  th Format
                  td yaml
                  td markdown
                  td json/yaml
                tr.fragment.highlight-current-blue
                  th Github (repos)
                  td 587
                  td 293
                  td 2209
                tr.fragment.highlight-current-blue
                  td
                    b Stackoverflow
                  td 330
                  td 770
                  td 3802
          section
            h3 Back to swagger
            p
              i.fa.fa-arrow-right.fa-3x
        section
          h2 License
          p.fragment Apache 2.0
        section(tagcloud large)
          h2 Support for
          p.fragment.
            CLOJURE
            D
            Erlang
            GO
            HASKELL
            JAVA
            JAVASCRIPT
            TYPESCRIPT
            .NET
            NODE.JS
            PERL
            PHP
            PYTHON
            RUBY
            SCALA
        section
          h2 Features
          p.fragment Specification
          p.fragment
            i.fa.fa-arrow-down
          ul
            li.fragment Documentation
            li.fragment Sandboxes
            li.fragment Client code generation
            li.fragment Server code generation
            li.fragment Design-First Approach
        section
          h2 When to integrate?
          p.fragment(data-fragment-index="0")
            | Top down
            br
            i.fa.fa-arrow-down.fa-3x
          img(src=require("./assets/swagger_logo.png") style="background: none; border: none;")
          p.fragment(data-fragment-index="1")
            i.fa.fa-arrow-up.fa-3x
            br
            | Bottom up
        section
          h2 Specification
          h3 Format
          p.fragment JSON, YAML
          p.fragment
            | data types:
            a(href="http://json-schema.org/") JSON Schema Draft 4
        section
          h2 Specification
          h3 Structure
          ol
            li
              p
                b.fragment Info
                br
                q.fragment The object provides metadata about the API.
            li
              p<commit_msg>fix space<commit_after>doctype html
html(lang="en")
  head
    title An introduction to swagger
  body
    .reveal
      .slides
        section
          h2 An introduction to
          h1 swagger
          img(src=require("./assets/swagger_logo.png") style="background: none; border: none;")
          p
            i by <NAME>
        section
          h2 Motivation
          figure.fragment.fade-in
            img(src=require("./assets/motivation.jpg") style="height: 500px;")
            figcaption (by geek-and-poke.com)
        section
          h2 What is swagger?
          p.fragment
            | Swagger is a formal
            a(href="http://swagger.io/specification/")  specification
            |  surrounded by a large ecosystem of
            a(href="http://swagger.io/tools/")  tools
            |  for REST APIs.
        section
          section
            h1 Why swagger?
            p.fragment
              i.fa.fa-arrow-down.fa-3x
          section
            h2 Alternatives
            ul
              li.fragment RAML
              li.fragment API Blueprint
          section
            h2 Common goals
            ul
              li Easy to write
              li Comfortable to read
              li Documentation / Client / Server generation
              li Language agnostic
          section
            h2 What about WSDL 2.0?
            ul
              li.fragment Core concept SOAP not REST oriented
              li.fragment Sparse documentation
              li.fragment Limited community
              li.fragment Hard to read
              li.fragment Tedious to write
              li.fragment Limited REST specific tool chain
          section
            h2 Comparison
            table
              thead
                tr
                  th
                  th RAML
                  th API Blueprint
                  th Swagger
              tbody
                tr.fragment.highlight-current-blue
                  th Format
                  td yaml
                  td markdown
                  td json/yaml
                tr.fragment.highlight-current-blue
                  th Github (repos)
                  td 587
                  td 293
                  td 2209
                tr.fragment.highlight-current-blue
                  td
                    b Stackoverflow
                  td 330
                  td 770
                  td 3802
          section
            h3 Back to swagger
            p
              i.fa.fa-arrow-right.fa-3x
        section
          h2 License
          p.fragment Apache 2.0
        section(tagcloud large)
          h2 Support for
          p.fragment.
            CLOJURE
            D
            Erlang
            GO
            HASKELL
            JAVA
            JAVASCRIPT
            TYPESCRIPT
            .NET
            NODE.JS
            PERL
            PHP
            PYTHON
            RUBY
            SCALA
        section
          h2 Features
          p.fragment Specification
          p.fragment
            i.fa.fa-arrow-down
          ul
            li.fragment Documentation
            li.fragment Sandboxes
            li.fragment Client code generation
            li.fragment Server code generation
            li.fragment Design-First Approach
        section
          h2 When to integrate?
          p.fragment(data-fragment-index="0")
            | Top down
            br
            i.fa.fa-arrow-down.fa-3x
          img(src=require("./assets/swagger_logo.png") style="background: none; border: none;")
          p.fragment(data-fragment-index="1")
            i.fa.fa-arrow-up.fa-3x
            br
            | Bottom up
        section
          h2 Specification
          h3 Format
          p.fragment JSON, YAML
          p.fragment
            | data types:
            a(href="http://json-schema.org/")  JSON Schema Draft 4
        section
          h2 Specification
          h3 Structure
          ol
            li
              p
                b.fragment Info
                br
                q.fragment The object provides metadata about the API.
            li
              p
{'fraction_non_alphanumeric': 0.050776079894116234, 'fraction_numerical': 0.012513536277222957, 'mean_word_length': 0.9516318384597323, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1947036', 'n_tokens_mistral': 2105, 'n_tokens_neox': 1954, 'n_words': 580}