Do you like the new look of the Maps APIs tutorials?
technical writer for the Google Maps APIs
Until recently, our docs have focused on describing features rather than telling a story. We chatted to some developers and came up with a new design for our tutorials. We’d love to know what you think of them.
Developers tell us they want quick, straightforward guides on how to integrate the Google Maps APIs into their app. The most common thing people want to do is to add a map with a marker. Just show me how to do that.
Developers are also looking for complete, step-by-step tutorials for the most common use cases. Guides that go all the way from a to z, with no deviations.
And they want code. Front and foremost. All the code.
Here are some examples of the new-look tutorials:
- Adding a map with a marker - web, Android and iOS.
- Styling your map - web, Android and iOS.
- Showing the business or other point of interest at the current location - Android and iOS.
Each tutorial provides the entire development project, especially useful for the native mobile APIs. The doc page goes hand in hand with a new sample app on GitHub. For example, here’s the code for the current place tutorial on Android.
We’ve made a good start, but there’s plenty of change still to come. What would you like to see more of? Are we on the right track? The tech writing team would love your ideas—please add comments to this post.