From 013e395f5cddc2f8ab044ef8c9e4cd350f505683 Mon Sep 17 00:00:00 2001
From: Oliver Tonnhofer <olt@bogosoft.com>
Date: Tue, 14 Aug 2018 08:50:52 +0200
Subject: [PATCH] doc: add note about YAML format

---
 docs/mapping.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/mapping.rst b/docs/mapping.rst
index 0fb3c5c..fdff4b4 100644
--- a/docs/mapping.rst
+++ b/docs/mapping.rst
@@ -5,6 +5,9 @@ The data mapping defines which `OSM feature types <http://wiki.openstreetmap.org
 
 See `example-mapping.yml <https://raw.githubusercontent.com/omniscale/imposm3/master/example-mapping.yml>`_ for an example.
 
+.. note::
+  The `YAML format <https://en.wikipedia.org/wiki/YAML>`_ uses indentations to indicate nesting. Tab characters are not allowed.
+  Quotes around simple strings are optional with YAML. ``"simple_string"``, ``'simple_string'`` and ``simple_string`` are all equal. However, numbers and boolean values (``yes``, ``no``, ``true``, ``false``) need to be quoted when they should be interpreted as a string (for example, when filtering ``building: ['no']``).
 
 Tables
 ------
@@ -112,7 +115,7 @@ The following mapping only imports buildings with a `name` tag. Buildings with `
           require:
             name: [__any__]
           reject:
-            building: [no, none]
+            building: ['no', none]
           reject_regexp:
             level: '^\D+.*$'
         mapping: