show when additional properties are allowed, fixes #19

examples/docs/abstract.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/abstract
 
 This is an abstract schema. It has `definitions`, but does not declare any properties
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Cannot be instantiated | Yes | Forbidden | [abstract.schema.json](abstract.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Cannot be instantiated | Yes | Forbidden | Permitted | [abstract.schema.json](abstract.schema.json) |
 
 # Abstract Definitions
 

examples/docs/arrays.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/arrays
 
 This is an example schema with examples for multiple array types and their constraints.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [arrays.schema.json](arrays.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [arrays.schema.json](arrays.schema.json) |
 
 # Arrays Properties
 

examples/docs/complex.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/complex
 
 This is an example schema that uses types defined in other schemas.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [complex.schema.json](complex.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Forbidden | [complex.schema.json](complex.schema.json) |
 
 ## Schema Hierarchy
 
@@ -31,6 +31,7 @@ This is an example schema that uses types defined in other schemas.
 | [reflist](#reflist) | Simple | Optional | Complex References  (this schema) |
 | [refnamed](#refnamed) | Simple | Optional | Complex References  (this schema) |
 | [xor](#xor) | complex | Optional | Complex References  (this schema) |
+| `*` | `any` | Optional | this schema *allows* additional properties |
 
 ## and
 

examples/docs/constants.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/constants
 
 This is an example schema with examples for properties with constant values
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [constants.schema.json](constants.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [constants.schema.json](constants.schema.json) |
 
 # Constant Types Properties
 

examples/docs/custom.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/custom
 
 This is an extensible schema. It has `definitions`, that can be used in other schemas. Additionally, it allows custom properties.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | Yes | Allowed | [custom.schema.json](custom.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | Yes | Allowed | Permitted | [custom.schema.json](custom.schema.json) |
 
 # Custom Properties
 

examples/docs/deepextending.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/deepextending
 
 This is an extending schema. It is extending another extending schema. It pulls `definitions` from other schemas.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | Yes | Forbidden | [deepextending.schema.json](deepextending.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | Yes | Forbidden | Permitted | [deepextending.schema.json](deepextending.schema.json) |
 
 ## Schema Hierarchy
 

examples/docs/definitions.schema.md

@@ -25,9 +25,9 @@ Bre-
 
 aks.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | Yes | Forbidden | [definitions.schema.json](definitions.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | Yes | Forbidden | Permitted | [definitions.schema.json](definitions.schema.json) |
 
 # Definitions Properties
 

examples/docs/enums.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/enums
 
 This is an example schema with examples for properties with enum values
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [enums.schema.json](enums.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [enums.schema.json](enums.schema.json) |
 
 # Enumerated  Properties
 

examples/docs/example.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/example
 
 This is an example schema with examples. Too many examples? There can never be too many examples!
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [example.schema.json](example.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [example.schema.json](example.schema.json) |
 
 ## Example Example
 ```json

examples/docs/examples.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/examples
 
 This is an example schema with *multiple* examples. Too many examples? There can never be too many examples!
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [examples.schema.json](examples.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [examples.schema.json](examples.schema.json) |
 
 ## Examples Examples
 

examples/docs/extending.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/extending
 
 This is an extending schema. It pulls `definitions` from other schemas.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | Yes | Forbidden | [extending.schema.json](extending.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | Yes | Forbidden | Permitted | [extending.schema.json](extending.schema.json) |
 
 ## Schema Hierarchy
 

examples/docs/extensible.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/extensible
 
 This is an extensible schema. It has `definitions`, that can be used in other schemas
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Cannot be instantiated | Yes | Forbidden | [extensible.schema.json](extensible.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Cannot be instantiated | Yes | Forbidden | Permitted | [extensible.schema.json](extensible.schema.json) |
 
 # Extensible Definitions
 

examples/docs/simple.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/simple
 
 This is a *very* simple example of a JSON schema. There is only one property.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [simple.schema.json](simple.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [simple.schema.json](simple.schema.json) |
 
 # Simple Properties
 

examples/docs/simpletypes.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/simpletypes
 
 This is an example schema with examples for multiple types and their constraints.
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Can be instantiated | No | Forbidden | [simpletypes.schema.json](simpletypes.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Can be instantiated | No | Forbidden | Permitted | [simpletypes.schema.json](simpletypes.schema.json) |
 
 # Simple Types Properties
 

examples/docs/subdir/subdir.schema.md

@@ -11,9 +11,9 @@ https://example.com/schemas/subdir/subdir
 
 A schema in a sub directory
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| Cannot be instantiated | Yes | Forbidden | [subdir/subdir.schema.json](subdir/subdir.schema.json) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| Cannot be instantiated | Yes | Forbidden | Permitted | [subdir/subdir.schema.json](subdir/subdir.schema.json) |
 
 # Subdir Definitions
 

examples/generated-schemas/complex.schema.json

@@ -64,5 +64,6 @@
     },
     "required": [
         "refabstract"
-    ]
+    ],
+    "additionalProperties": true
 }
\ No newline at end of file

examples/schemas/complex.schema.json

@@ -47,5 +47,6 @@
   },
   "required": [
     "refabstract"
-  ]
+  ],
+  "additionalProperties": true
 }

lib/markdownWriter.js

@@ -172,7 +172,7 @@ const generateMarkdown = function(filename, schema, schemaPath, outDir, dependen
   ];
 
   if (_.keys(schema.properties).length > 0) {
-    multi.push([ 'properties.ejs', { props: requiredProperties(schema.properties, schema.required), title: schema.title } ]);
+    multi.push([ 'properties.ejs', { props: requiredProperties(schema.properties, schema.required), title: schema.title, additional: schema.additionalProperties } ]);
     for (let i=0; i<_.keys(schema.properties).length;i++) {
       const name = _.keys(schema.properties).sort()[i];
       multi.push( [ 'property.ejs', {

templates/md/header.ejs

@@ -16,9 +16,9 @@
 
 
 
-| Abstract | Extensible | Custom Properties | Defined In |
-|----------|------------|-------------------|------------|
-| <%=props.abstract %> | <%=props.extensible %> | <%=props.custom %> | [<%=props.original %>](<%=props.original %>) |
+| Abstract | Extensible | Custom Properties | Additional Properties | Defined In |
+|----------|------------|-------------------|-----------------------|------------|
+| <%=props.abstract %> | <%=props.extensible %> | <%=props.custom %> | <%= schema.additionalProperties===true ? "Forbidden" : "Permitted"  %> | [<%=props.original %>](<%=props.original %>) |
 
 <% if (dependencies.length > 0) { %>
 ## Schema Hierarchy

templates/md/properties.ejs

@@ -18,4 +18,6 @@
       %><%= title %> (this schema)<% } %> |
 <%
 });
-%>
+%><% if (additional) { %>
\ No newline at end of file
+| `*` | `any` | Optional | this schema *allows* additional properties |
+<% } %>
\ No newline at end of file