Skip to content

About

Learn Postman — a friendly, interactive, step-by-step guide to using Postman for absolute beginners.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Postman for Absolute Beginners

A super-simple, step-by-step website that teaches a total newcomer how to use Postman — with a left sidebar table of contents, Prev/Next buttons, Mermaid diagrams, and a hover-to-define Jargon Decoder.

No build step. No frameworks. Just static files — perfect for GitHub Pages.

What's in this build

  • Working shell: sidebar navigation, Prev/Next, search, dark/light mode, glossary.
  • Full content: Part 0 (APIs & HTTP), Part 1 (Setup), Part 2 (Your First Request).
  • Stubs for Parts 3–10 + Appendix so you can see the full shape (marked "soon").

Files

index.html          # the page shell
assets/styles.css   # all styling (light + dark)
assets/content.js   # every lesson page + the sidebar order  ← edit content here
assets/glossary.js  # the jargon definitions                 ← edit terms here
assets/app.js       # navigation, diagrams, tooltips, search
.nojekyll           # tells GitHub Pages to serve files as-is

Run it locally

Just open index.html in a browser — everything works from the file system (no server needed).

Publish to GitHub Pages

  1. Create a repo and push these files (keep index.html at the repo root).
  2. On GitHub: Settings → Pages.
  3. Under Build and deployment → Source, pick Deploy from a branch.
  4. Choose branch main and folder /(root), then Save.
  5. Wait ~1 minute — your site is live at https://<your-username>.github.io/<repo-name>/.

Add or edit a lesson

Open assets/content.js. Each page is an object:

{ id: "my-page", num: "3.2", title: "My topic", html: `...` }
  • Add it to the right part's pages array — the sidebar and Prev/Next update automatically.
  • Wrap a jargon word: <span class="jargon" data-term="api">API</span> (the data-term must match a key in glossary.js).
  • Add a diagram: <div class="mermaid">flowchart LR; A --> B</div>

After editing — bump the cache version

The asset links in index.html end with ?v=6 (e.g. content.js?v=6). This forces browsers to fetch your new files instead of an old cached copy. Each time you change a file in assets/, increase that number (?v=6 → ?v=7) on all four links so returning visitors always get the latest version.

About

Learn Postman — a friendly, interactive, step-by-step guide to using Postman for absolute beginners.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages