Skip to content

Releases: RapidAPI/paw-gql-markdown

0.2.0-alpha

16 Mar 13:18
3dc80d3
Compare
Choose a tag to compare
0.2.0-alpha Pre-release
Pre-release

CHANGELOG [03/16/22]

Current version 0.2.0-alpha. Please refer to README.md for installation and usage.

  • feat: frontmatter, a feature that is currently in test-drive mode
  • bugfix: custom comment tags doesn't render output accordingly

0.1.2-alpha

09 Mar 12:17
32db34a
Compare
Choose a tag to compare
0.1.2-alpha Pre-release
Pre-release

CHANGELOG [03/09/22]

Current version 0.1.2-alpha. Please refer to README.md for installation and usage.

  • bugfix: removed formatting for mutation, causes the app to crash when mutation syntax is invalid.

CHANGELOG [03/06/22]

0.1.1-alpha.

  • bugfix: GraphQL variable object children doesn't get included.

CHANGELOG [03/04/22]

v0.1.0-alpha. Please refer to README.md for installation and usage.

  • initial version
  • feat: automatically generate requests' markdown docs
  • feat: export markdown docs for a single or multiple request
  • feat: customize example code block placements

0.1.1-alpha

06 Mar 18:30
377626e
Compare
Choose a tag to compare
0.1.1-alpha Pre-release
Pre-release

CHANGELOG [03/06/22]

Current version 0.1.1-alpha. Please refer to README.md for installation and usage.

  • bugfix: GraphQL variable object children doesn't get included.

CHANGELOG [03/04/22]

v0.1.0-alpha. Please refer to README.md for installation and usage.

  • initial version
  • feat: automatically generate requests' markdown docs
  • feat: export markdown docs for a single or multiple request
  • feat: customize example code block placements

v0.1.0

04 Mar 17:40
563577d
Compare
Choose a tag to compare
v0.1.0 Pre-release
Pre-release

CHANGELOG

  • initial version 0.1.0-alpha
  • automatically generate requests' markdown docs
  • export markdown docs for a single or multiple request
  • customize example code block placements

GraphQL Markdown Doc Generator

Installation

  • Download the latest release here.
  • Go to Paw > Preferences or simply use the keyboard shortcut: cmd + ,
  • Click on the Extensions tab > Open Directory, extract the content of the zip file in that directory.
  • You should see GraphQLDocs Generator listed.
  • Create a new Request, and on the Generators dropdown, select GraphQLDocs

Usage

By default, GraphQLDocs will generate a markdown document based on the Request information
available. Basic Response information will only be available if there's at least one Http Exchange. It will
always render the latest exchange.

You may also customize the documentation output by using the comment tags on the
description textarea like so:

### Request 101

This comment tag below will render the request's headers.

<!-- request:headers -->

This comment tag below will render the request's body

<!-- request:body -->

By appending `:collapsed` to the tag will wrap the code block with `<details> ... </details>` markup tag
which makes it collapsible when rendered in Github Markdown.

Here's a list of available comment tags:

Request Headers
<!-- request:headers -->
or
<!-- request:headers:collapsed -->

Request URLParams
<!-- request:urlparams -->
or
<!-- request:urlparams:collapsed -->

Request Body
<!-- request:body -->
or
<!-- request:body:collapsed -->

Response Headers
<!-- response:headers -->
or
<!-- response:headers:collapsed -->

Response Body
<!-- response:body -->
or
<!-- response:body:collapsed -->

Export Markdown doc for single Request

Screen Shot 2022-03-04 at 20 13 05

Export Markdown for multiple Request

Screen Shot 2022-03-04 at 20 13 48