📝 Extend README

Author: Sergei Orlov

README.md

@@ -14,6 +14,8 @@
 
 Gatsby source plugin for working with official [Notion](https://notion.so) API.
 
+Here's a [Postman](https://www.postman.com/) collection to play around with the API if you're interested: [https://www.postman.com/notionhq/workspace/notion-s-public-api-workspace/overview](https://www.postman.com/notionhq/workspace/notion-s-public-api-workspace/overview)
+
 ## 🚧 It's a work in progress
 
 This is a source plugin for pulling content into Gatsby from official public Notion API (currently
@@ -42,10 +44,13 @@ Before using this plugin, make sure you
 1. Created a Notion integration (sign in to Notion, go to `Settings & Memberships` → `Integrations`
  → `Develop your own integrations`,
  [short link to the Integrations creation section](https://www.notion.so/my-integrations)). It's
- OK to use an internal one. Don't forget to copy the token.
-2. Go to the database you want to have access to and share it with the integration (`Share` → Select
+ OK to use an internal one. Don't forget to copy the token:
+ ![Notion integration creation GIF](https://files.readme.io/2ec137d-093ad49-create-integration.gif)
+2. Go to the database you want to have access to from Gatsby, and share it with the integration (`Share` → Select
  the integration in the `Invite` dropdown). Don't forget the database in the URL. It's a series of
- characters after the last slash and before the question mark. Here's a reference:
+ characters after the last slash and before the question mark.
+ ![Notion integration sharing GIF](https://files.readme.io/0a267dd-share-database-with-integration.gif)
+ Here's a reference:
  https://www.notion.so/{USER}/**{DATABASE_ID}**?{someotherirrelevantstuff}
 3. Then add this to your `gatsby-config.json`:
 
@@ -85,23 +90,83 @@ query {
 allNotion {
 edges {
 node {
+title
+properties
+archived
+createdAt
+updatedAt
+children
 raw
 }
 }
 }
 }
 ```
 
+## Node properties
+
+### `id`
+
+Unique page identifier. This is not a Notion page identifier. You can get the Notion page id under `raw.id`.
+
+### `parent` (Node)
+
+Parend Node.
+
+### `children`
+
+Blocks that belong to the page.
+
+### `title` (String)
+
+Page title joined into one string.
+
+### `properties`
+
+Properties of the page. An object with keys representing database columns (snake-cased), and the following value:
+
+#### `id` (String)
+
+Notion column id
+
+#### `key` (String)
+
+Readable name of the column (without snake case).
+
+#### `value` (\*)
+
+Value of the column for the page. Might have different structure depending on the type.
+
+#### `type` (String)
+
+Notion type of the column.
+
+### `archived` (Boolean)
+
+Boolean. Is **true** if the pages was marked removed but not removed permanently.
+
+### `createdAt` (Date)
+
+Date of page creation.
+
+### `updatedAt` (Date)
+
+Date of the last page update.
+
+### `raw` (\*)
+
+Untouched contents of whatever Notion API returned.
+
 ## Current state
 
 - Due to the fact that Notion API only appeared recently, and it is still in beta, some blocks are
  marked "unsupported". Among others, images cannot be fetched for now
 - Currently, `gatsby-source-notion-api` can only work with one provided database. In further
  releases, all databases reachable by the Integration will be available for querying
-- Nested blocks are currently skipped. E.g. if a list item has a nested sublist, it's contents will
- be omitted. This will be fixed in the nearest releases
-- Only raw content is available. Raw meaning whatever Notion returns. Further releases will aim at
- providing a more convenient data format apart from the raw one
+- ~~Nested blocks are currently skipped. E.g. if a list item has a nested sublist, it's contents will
+ be omitted. This will be fixed in the nearest releases~~ Nested blocks are supported as of `0.4.0`!
+- ~~Only raw content is available. Raw meaning whatever Notion returns. Further releases will aim at
+ providing a more convenient data format apart from the raw one~~ `0.3.0` features support for **archived**, **createdAt**, **updatedAt**, **properties** and **title**.
 
 ## 🎉 You did it