API content is outdated

[stumblefiend]

For specifics on what is outdated, see #2169 (comment)

In general, we need a pillar page about Writing API Documentation and it could link to sub-pages / topics like

• Introduction to APIs
• Best Practices for API Documentation
• Tools for API Documentation

[plaindocs]

So this is 100% accurate, and is a product of the fact that nobody is (or has? @stumblefiend ) is really driving the Guide content. So someone once wrote about API Blueprint and that is now what we have.

I wonder if there is a world in which we could ask for volunteers to build out topics, in a similar way to the newsletter, but on a slower timeframe. It's a BIG ask though.

Running a writing day sprint, with a better idea of what we want is one way to go.