Skip to content
This repository has been archived by the owner on Jan 10, 2021. It is now read-only.

Specification: topics

Hugo Roy edited this page Oct 2, 2014 · 4 revisions

Version 1.1. 2014-10-2

id

The id is used by other files to refer to a specific json file.

Keep it simple, lowercase. Use a "-" for any non-Az-01 character.

For instance: "jurisdiction-law"

title

This is the title of the topic as the user sees it.

For instance: "Jurisdiction and governing laws"

subtitle

To complement the title.

For instance: "Where can you sue, or be sued, for breaching of the rules?"

description

A paragraph to describe the topics more indepth. Don't hesitate to add links to articles about the subejct but keep it short enough.

type

Can be "topic" or "category". Categories are usually broad topics with many child-topics.

category

When a topic belongs to a category, use the category's "id" to refer to it.

For instance: "category": "governance" for the "jurisdiction-law" topic.

meta

Meta information

meta > spec-version

Which version of this spec the file is using. (Useful to maintain API versioning).

Clone this wiki locally