Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I've brought this up before, and even though I don't use the service much anymore, I still love Airtable's API documentation - they customize the API calls for the table you're actually on, so instead of the generic example of "say you want to create a new CAR entry linked to the SEDAN category, with the RED color property", it pulls the names of fields/etc. to use in the examples from your actual table.

It's a small detail, but is still one of my favorite examples of making documentation more concrete.



I always appreciate it when documentation does this. Is there a technical term for this implementation?


I suggest "Contextual examples"




Consider applying for YC's Winter 2027 batch! Applications are open till November 2.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: