This document provides a guide for how documentation is structured in Nexmo Developer.
Nexmo Developer content should be designed to be clear, concise and consistent in that order.
Exceptions can be made to break consistency where it makes sense, particularly in scenarios where the content would be unnecessarily verbose or the structures outlined in this guide are unsuited to the material.
Nexmo Developer is structured by context and by product. The four main sections of Nexmo Developer are:
- API References
- SDKs and Tools
This section hosts the bulk of the written content for the NDP. The content is structured by products each of which have the following four sections:
- Overviews - The first pages you reach when you select a product.
- Guides - Provide key concepts in more depth than the overview.
- Code Snippets - Used as a quick reference of how to do something specific.
- Tutorials - Step-by-step guide on how to do something. There is also a detailed guide to tutorials available.
- Use Cases - Multi-product scenarios using Vonage APIs and those of other providers.
API Reference pages document the following properties of the API:
- Resource Model
A section that outlines our SDKs, Tools, Libraries etc. The repository README should provide all necessary information.
As it develops, the community section will be a repository for 'cool hacks', open source projects that use Nexmo, the events that Nexmo will attend or sponsor, and blog posts that the community has written about Nexmo.