Socrata API Foundry V2 Extends Tailored Documentation

Socrata API Foundry have launched a new feature that will minimize the gap between the two tiers of their existing documentation output system.

The API Foundry v1 took a client's dataset and created developer-ready API documentation, complete with how to query and interact with the API. However, it also created a lower-tier output for normal Socrata datasets, which produced a lower-end developer experience.

Socrata's new automatic API documentation feature in v2, which is available immediately, generates Foundry-style API documents for every Socrata dataset. These documents will be integrated with the rest of Socrata’s developer resources and documentation. The APIs created are fully RESTful, offering a powerful, expressive SQL-like query language that is familiar to developers.

Along with the launch of the new feature, the company has also announced the deprecation of API Foundry v1 and the Foundry wizard. The old and new versions will run concurrently until February 1, 2015, when v1 and the Foundry wizard will be disabled. Old API documentation pages will be redirected to equivalent templates in the new automatic documentation format.

The company also announced the launch of their new Socrata developer program, focused on improving the experience for the civic developer community.

Original Article

Announcing: Automatic API Documentation

Martin W Brennan Martin W Brennan is a co-founder of ViewPop, the social network that puts the creation of 3D photos and videos in the hands of anyone with a smartphone. For his day job, Martin is a copywriting consultant at We Write Words, learning about the world as he writes about it.