~/talk

Writing Docs Is a Chore

Talkat Postman Galaxy 2021 · 2021-02-02..02-04· [documentation, developer-experience]
links:none on file
slides:none on file

Claim: documentation that used to take days now generates in minutes. Pipeline reads metadata and 805,000 record datasets from MTNA’s Rich Data Services, renders Postman JSON via a Java model and velocity templates, runs the collection with a custom Newman example generator to capture real responses, and updates published docs through the Postman API. Resulting collection imports with 24 requests, saved example responses and visualizers, and the automated flow works end to end.

AI-written summary · about

  1. 0:00Start
  2. 2:35Coding the Data
  3. 3:29Metadata
  4. 6:02Selecting the Data
  5. 6:37Querying Data
  6. 13:38Data Set Level Documentation
  7. 25:57Resources
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.