postman-docs

by postmanlabs

postmanlabs / postman-docs

Documentation for Postman, a collaboration platform for API development. Available for Mac, Windows ...

182 Stars 235 Forks Last release: Not found Apache License 2.0 7.3K Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Postman logo

Postman Learning Center

Postman is the collaboration platform for API development. And the Postman Learning Center has the resources you need to ramp up quickly and extend your skills with Postman. Postman allows you to write API test cases in any format of your choice (JSON/XML/many more) and run them to verify and validate your API. Moreover, Postman provides collections which can improve a developer's workflow. Postman is available for several platforms including windows and Mac OS X. For more information visit the Postman website.

Contribution guidelines

We would love for you to contribute to the Learning Center! To contribute to this project, please read:

NOTE: We have added a new Markdown linter with GitHub Actions. When making a pull request, it will run against this linter. Your changed files are required to pass linting before they will be merged. More information on this can be found in the contribution guidelines.

To say thank you for your contribution, we’d love to send you exclusive Contributor swag. Fill out the Contributor Submission form and we’ll send you a token of our gratitude.

Build the Learning Center locally

   $ git clone https://github.com/postmanlabs/postman-docs.git
   $ cd postman-docs
   $ npm install
   $ npm install -g gatsby-cli
   $ npm run dev

NOTE: this site was build with node v12.11.0. We recommend installing and using nvm and setting your node version to v12.11.0.

Build using Docker

You can build the Learning Center and run it in a Docker container using the following dockerfile.

  1. Start by cloning the the repository

git clone https://github.com/postmanlabs/postman-docs.git
  1. Create a file and name it "dockerfile" with the following contents

    FROM node:12
    
    

    EXPOSE 8000

    copy the postman-docs project directory

    COPY postman-docs /var/postman-docs

    WORKDIR "/var/postman-docs"

    RUN npm install -g gatsby-cli RUN npm install --force

    CMD ["yarn", "dev", "-H", "0.0.0.0" ]

    The dockerfile should be in the same directory as the postman-docs directory

    # example directory structure
    |--[current folder]
       |--postman-docs
       |--dockerfile
    
    

  2. Build the Docker image with this command:

$ docker build --tag postman-docs:1.0 .
  1. Start a container using the image

$ docker run -p 8000:8000 -d postman-docs:1.0

Docker Compose

You can also build with docker-compose using the dockerfile above and this docker-compose.yaml

version: '3'
services:
  node:
    build:
      context: ./
    ports:
      - "8000:8000"

The docker-compose.yaml should be in the same directory as the postman-docs directory and dockerfile.

# example directory structure
|--[current folder]
   |--postman-docs
   |--dockerfile
   |--docker-compose.yaml

Start run the container with this command

$ docker-compose up

Project Structure

The built site will only host the most up-to-date docs. All legacy documentation is stored in github and excluded from build.

To update the docs

  • Posts are maintained under the

    /src/pages/docs
    folder.
  • The folder structure of /docs is the URL structure for posts. For example,

    /docs/postman/variables-and-environments/variables.md
    is mapped to URL
    https://learning.postman.com/docs/postman/variables-and-environments/variables/
    .
  • Links in the docs should be relative. Example:

   [Newman](/docs/postman/collection-runs/command-line-integration-with-newman/)

Resources

License

Apache License 2.0

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.