postmanlabs / devrel-content Goto Github PK

View Code? Open in Web Editor NEW

10.0 6.0 7.0 76 KB

Project to track content creation requests and progress for the Postman Developer Relations team.

Home Page: https://www.postman.com/devrel

content devrel postman api

devrel-content's Introduction

Manage all of your APIs in Postman, with the industry's most complete API platform.

What is this repo for?

This repository is used by the Developer Relations team at Postman to track requests and progress on new content.

To create a new request, open a new issue
To see the current progress on requests, check the project board

Content Types

Type	Description	Destination(s)
Video	Pre-recorded video, usually walking through some product flows from short form (~2min) to long form (~15mins). Can be one of: Exploratory How To Level Up Other	Postman Youtube Channel
Blog		Postman Blog Better Practices
Collection		Postman Answers Workspace
Tutorial
Talk	Any meetup or event that you're speaking at. Could be a workshop, Postman demo, lightning talk, etc

Product roadmap

Keep tabs on new and upcoming releases on the product roadmap. Track current issues and log new ones on GitHub. Also submit new feature requests here.

Documentation and tutorials

Head over to our documentation, visit our blog, and check out our YouTube channel for interesting tutorials, development stories, and platform updates.

devrel-content's People

Contributors

Stargazers

Watchers

Forkers

therakeshpurohit isabella232 jansche samkenxstream naisofly meslubi2021

devrel-content's Issues

15 days of Postman - for testers

Describe the content you'd like to see

✅ Workspace
✅ Blog re: 15 days - submitted for review
✅ Video
✅ Hiring matrix
✅ Blog re: Postman skills hiring matrix - submitted for review
✅ Badge
✅ TikTok series

Video re: Postman skills hiring matrix

Content Type

Collection, Video, Blog

If the request is for a video, indicate which type

No response

Describe the content you'd like to see

✅ Newman extension in Docker extension marketplace
✅ Docker guest post: https://www.docker.com/blog/automate-api-tests-and-debug-in-docker-with-postmans-newman-extension/
✅ Docker video (on personal channel)
✅ Recording for community all-hands December 8

Content Type

No response

If the request is for a video, indicate which type

No response

How to link to a Postman workspace from your docs - devex

Describe the content you'd like to see

With examples

Twitter blue button
Okta RIP directory
MongoDB from within worfklow
ARcGIS examples?
Dynamic RIP - DocuSign (?)
Get started - Twilio

DRAFT: https://docs.google.com/document/d/1koFIM2eE8DyJRl_M30WfrZMz3NCFMIvR7wo6F0vdYBc/edit?usp=sharing

Content Type

Blog

If the request is for a video, indicate which type

No response

Describe the content you'd like to see

Either guest post or story about AMEX and Postman usage

Content Type

Blog

If the request is for a video, indicate which type

No response

Describe the content you'd like to see

A video that highlights how to work with your source control repository in Postman.

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Describe the content you'd like to see

An exploratory that walks through how to run collections using Newman.

run a collection locally
run a collection using Postman API
attach an environment
explore results
anything else?

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Create content about audit logs

Describe the content you'd like to see

An updated blog or brief explainer video about audit logs would be helpful to team admins. Currently we have a content gap on the sidebar of the doc.

Content Type

Video, Blog

If the request is for a video, indicate which type

Other

Level Up - Create a Postman collection

Describe the content you'd like to see

Short Level Up showing how to get started with collections in Postman

Create new collection
Save a request
Fork an existing collection from PW or RIP to edit

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Describe the content you'd like to see

Level Up similar to https://www.youtube.com/watch?v=OOkKkH5bXHg showing the duplicate feature

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Describe the content you'd like to see

We currently don't have any content for the sidebar on Using the Scratch Pad. Not sure what type of content would be most useful, but maybe a brief Level Up video or blog post?

Content Type

Video

If the request is for a video, indicate which type

Other

Describe the content you'd like to see

Vikram is working on a blogpost that highlights the 3 following features in Postman:

Move
Duplicate
Share

Content Type

Blog

If the request is for a video, indicate which type

No response

Create curated list of APIs that help in community management

Describe the content you'd like to see

I would like to create a blog post similar to Sean's that describes some of the APIs I use to help grow the Postman community. This would be targeted mostly at other community managers.

Content Type

Blog

If the request is for a video, indicate which type

No response

Describe the content you'd like to see

Video demonstrating how to integrate with CircleCI in Postman.

Note: When this video goes live, we need to add a link to it under Related videos of the description of this video: https://youtu.be/rTTAVlUxfDc

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Describe the content you'd like to see

A short video about the token scanner would be helpful, especially for admins and security folks on larger teams. This is currently a content gap in the docs sidebar.

Content Type

Video

If the request is for a video, indicate which type

Level-Up

Build a Jamstack application in Postman

Describe the content you'd like to see

Jamstack app in Postman

Collection
Conference talk
External video
TikTok
Blog post (Postman, Medium, Dev.to)

Content Type

Collection

If the request is for a video, indicate which type

Other

Describe the content you'd like to see

NFT collection contracts: https://www.postman.com/nftport/workspace/nftport/overview

Content Type

Collection, Blog, Tutorial

GUEST blog
IMAGE can be: partner template with NFTport logo, or re: NFT collection contracts (e.g. smart contract like document icon with wires and nodes coming out, handshake, cloud, art)

ETA to support launch Feb 25, draft to be completed a week prior, if guest blog is published after the release that's fine by me

If the request is for a video, indicate which type

No response

Adding external libraries to Postman

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

We need a collection in Postman Answers that demonstrates how to use external libraries in Postman.

Ideally, we also want a blog post that explains the different ways to do it, and the benefits/drawbacks of each.

Part of the most frequently asked questions on the community forum:
https://community.postman.com/t/adding-external-libraries-to-postman/1971

Type of content needed

Collection, Blog

Code of Conduct

I agree to follow this project's Code of Conduct

Create blog post on using Twitch API to make a Slack bot

Describe the content you'd like to see

In addition to my first collection, I would like to create a blog post documenting my process in making a slack integration that helps you find content on Twitch.
Somewhat of a similar spin as this https://blog.postman.com/building-a-bot-for-busy-gamers/
Some key points would be how to handle refreshing your oauth token

Content Type

Collection, Blog

If the request is for a video, indicate which type

No response

AWS API Gateway integration

Describe the content you'd like to see

Need a video to support this release: https://blog.postman.com/deployments-aws-api-gateway-integration/

Content Type

Video

If the request is for a video, indicate which type

How-To

GitLab integration

Describe the content you'd like to see

With the new integrations in the API Builder, we need one showing how to set up the GitLab one

Content Type

Video

If the request is for a video, indicate which type

How-To

Create video covering migrating data between teams

Describe the content you'd like to see

A video may be helpful for admins migrating data between teams. Current content gap on the docs sidebar

Content Type

Video

If the request is for a video, indicate which type

How-To

Communication APIs project

Describe the content you'd like to see

Communication APIs project for talk at community meetups in the US/CAN (March through October) - schedule: https://airtable.com/appAdYaqxcTmDjM4X/tblY2JZP8sdk8HGtb/viw5SeDQC1gzhQCOg?blocks=hide
Workspace, code sample
Blog post

Content Type

Collection, Blog

If the request is for a video, indicate which type

No response

There are other collections for our API on the Postman network, what can we do to get rid of them?

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

I am getting this question regularly from people in the Postman Network. They have invested in their team profile and their workspaces, APIs, and collection. Then when they search via network or via Google they come across other workspaces with out-of-date collections. What can they do?

Tell that goofy API Evangelist dude to remove his workspace is always the first thing.
Comment on the other collection letting them know there is an official source to fork now.
What else? Let's get a story published somewhere on this to help educate the community about how things work, and what we are doing to help improve the experience.

Content Type

Blog

Code of Conduct

I agree to follow this project's Code of Conduct

BitBucket integration

Describe the content you'd like to see

With the new integrations in the API Builder, we need one showing how to set up the Bitbucket one

Content Type

Video

If the request is for a video, indicate which type

How-To

Exploratory - Working with your team

Describe the content you'd like to see

With the new workspaces we need a new video that shows how to work with your team in Postman.

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Crypto.js code sample in Postman Answers

Describe the content you'd like to see

crypto and cryptojs are popular zero-search result terms in the Learning Center. The library is included in the sandbox docs, but not indexed in the docs search due to a known limitation. There are also various questions on the community forum around usage of this library.

Include a code sample of various use cases with CryptoJS in Postman Answers public workspace. Can include code provided in this reference for Crypto.

Content Type

Collection, Tutorial (blog that links to collection), Level-Up video

If the request is for a video, indicate which type

Level-Up

How To - Share Postman collections

Describe the content you'd like to see

How To showing the different ways to share Postman Collections:

To a team workspace
To a public workspace
RIP
Link
export json

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Exploratory - Update to existing Collections video

Describe the content you'd like to see

We need to update the now out of date video on Collections in Postman. This one needs to include:

Benefits of collections
Use cases (documentation, grouping reqs, sharing, running workflows, test suites)
Collection variables, using with Env
Collection-level scripts, execution order
etc

This should be an Exploratory

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Exploratory - Reporting

Describe the content you'd like to see

A video on reporting in Postman, there are Reports available for Enterprise (cf https://blog.postman.com/introducing-new-postman-reports-for-enterprises/) but there are other ways to see what's happening in your Postman domain (workspace overview, changelog...).

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Sync your specs - Git for publishers

Describe the content you'd like to see

Better practice for API publishers with a public API

Content Type

Blog

If the request is for a video, indicate which type

No response

How to skip/ignore requests/tests

Describe the content you'd like to see

This can be split in two collections or using a single one, this should demonstrate how you can:

Ignore some tests in a single request
Ignore some requests during a collection run

This is one of the most watched topic on the community forum: https://community.postman.com/t/ignoring-tests-and-requests/671

Content Type

Collection

If the request is for a video, indicate which type

No response

Automatically set a token for a request

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

One of the most frequently searched for question is how to set a bearer token as a variable after calling a URL to get that token, we need a collection in Postman Answers that shows that.

Cf: https://community.postman.com/t/how-to-automatically-set-a-bearer-token-for-your-postman-requests/10126

Type of content needed

Collection

Code of Conduct

I agree to follow this project's Code of Conduct

How To - How to use variables to chain requests

Describe the content you'd like to see

A How To video demonstrating how you can use variables to chain requests in Postman.

Pre-req and test tabs
Extra data from a response
Use in a subsequent response
Execution order

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Create your own radio blog

Describe the content you'd like to see

Based on the livestream with Aflorithmic, create a blog that shows how you can create your own radio using APIs

Content Type

Collection, Blog

If the request is for a video, indicate which type

No response

Setting/getting collection variable value in script

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

We need a collection in Postman Answers that demonstrates how to set/get variables in scripts.

Part of the most frequently asked questions on the community forum:
https://community.postman.com/t/setting-getting-collection-variable-value-in-script/4851

Type of content needed

Collection

Code of Conduct

I agree to follow this project's Code of Conduct

Curated list: Databases

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

Create a new curated list re: Databases (or something else if you prefer) that includes at least these partners:

Optional to include in the intro: https://www.postman.com/postman/workspace/published-postman-templates/collection/5922408-41044117-22a7-4f36-869c-13f73310b7e9
Format - follow this example: https://blog.postman.com/top-payment-apis-fintech/
Categories - This is new. You will not need an in-app Postman list in Explore to link to from within the blog. Instead, ask #api-network to create a new category that includes these profiles once the blog has been published.
Existing request for blog featured image already with Linda: https://postmanlabs.atlassian.net/jira/core/projects/BE/board?issueKey=BE-57

Content Type

Blog

Code of Conduct

I agree to follow this project's Code of Conduct

How to ignore tests

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

We need a collection in Postman Answers that shows how to ignore tests based on a condition (can be based on the response, on a variable...).

This is part of the most frequently asked questions on the community forum:
https://community.postman.com/t/ignoring-tests-and-requests/671

Type of content needed

Collection

Code of Conduct

I agree to follow this project's Code of Conduct

Secret Variable

Describe the content you'd like to see

Level Up to explain secret variables in environment and globals

Content Type

Video

If the request is for a video, indicate which type

Level-Up

How To - Release management for APIs

Describe the content you'd like to see

How To videos on release management for APIs

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Import HAR file

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

Level up

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Compare 2 responses using Postman

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

We need a collection in Postman Answers that shows how to compare two responses using Postman, as shown in this topic https://community.postman.com/t/compare-2-responses-using-postman/1638

Type of content needed

Collection

Code of Conduct

I agree to follow this project's Code of Conduct

How to pass a comma separated array of integers in to an API Via CSV Data File

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

Need a collection that shows how to pass a comma separated array of integers in to an API Via CSV Data File, more info in this topic: https://community.postman.com/t/how-to-pass-a-comma-separated-array-of-integers-in-to-an-api-via-csv-data-file/743

Type of content needed

Collection

Code of Conduct

I agree to follow this project's Code of Conduct

How to pass array as a parameter

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

We need a collection in Postman Answers that shows how to pass an array as a parameter between requests. This will need to use JSON.parse and JSON.stringify.

This is part more of the most frequently asked questions on the community forum:
https://community.postman.com/t/how-to-pass-array-as-a-parameter/13673

Type of content needed

Collection

Code of Conduct

I agree to follow this project's Code of Conduct

Update workspaces blog

Describe the content you'd like to see

This blog has some great info for new users and growing teams, but is outdated (mentions sharing vs moving, has an unlisted video embedded). An updated version would be a nice addition to the sidebars on Creating a workspace and Creating workspaces.

Content Type

Blog

If the request is for a video, indicate which type

No response

Loop over a test based on the previous response's length

Describe the content you'd like to see

We need a collection in Postman Answers that shows how to loop over a request in a collection run based on the length of the previous response. e.g. response 1 sends an array of length 5, so the next request will run 5 times.

More details in this community post: https://community.postman.com/t/workflow-how-to-run-another-test-in-loop/2126

Content Type

Collection

If the request is for a video, indicate which type

No response

How to test properties and arrays correclty

Is there an existing request for this content?

I have searched the existing issues for this feature request

Describe the content you'd like to see

There are many ways to test array properties, it'd be great to have a collection that shows an overview of the different things that can be tested (existence of a key, type...), as outlined in that post: https://community.postman.com/t/testing-properties-and-arrays-correctly-in-get/7133

It'd also be great to have a blog highlighting the different ways to do so that redirects to that same collection as a demo.

Type of content needed

Collection, Blog

Code of Conduct

I agree to follow this project's Code of Conduct

"Good Public Workspace Checklist" blog post

Describe the content you'd like to see

A short blog post that is essentially a checklist of what makes a good public workspace. I often have partner calls where I say the same things about things they should include in their public workspace. Items to include

Overarching workspace:

A good name for the workspace (it becomes the URL)
A workspace summary

On workspace overview description:

Brief introduction of what's available in the workspace
A branded image (optional)
Link to developer documentation
Information on getting an API key

On collections:

Well named collections.
Examples for each endpoint
Authentication set up and appropriate variable place holders

On environments:

Any repeated variables throughout the workspace (baseUrl, apiKey, version, etc)

On team profile:

Team domain acquired
Branded profile image

Content Type

Blog

If the request is for a video, indicate which type

No response

Mock Better Practices

Describe the content you'd like to see

Working with Sean on a blog post for the Better Practices about Mocks

Content Type

Blog

If the request is for a video, indicate which type

No response

How To - Travis CI integration

Describe the content you'd like to see

A How To video that shows how to enable the Travis CI integration in Postman.

Content Type

Video

Code of Conduct

I agree to follow this project's Code of Conduct

Debugging Stackoverflow

Describe the content you'd like to see

API debugging

Last week of Feb

For THIRD PARTY blog only (this is not Postman blog, stackoverflow)

Content Type

Blog

If the request is for a video, indicate which type

No response