diff --git a/content/docs/extensions/camtrap-data-package.md b/content/docs/extensions/camtrap-data-package.md
index b97689ab..25efa2b0 100644
--- a/content/docs/extensions/camtrap-data-package.md
+++ b/content/docs/extensions/camtrap-data-package.md
@@ -4,7 +4,7 @@ title: Camera Trap Data Package
- Author(s) |
+ Authors |
Peter Desmet, Jakub W. Bubnicki, Camtrap DP Development Team |
diff --git a/content/docs/extensions/fiscal-data-package.md b/content/docs/extensions/fiscal-data-package.md
index be5c335a..00a19b5e 100644
--- a/content/docs/extensions/fiscal-data-package.md
+++ b/content/docs/extensions/fiscal-data-package.md
@@ -4,7 +4,7 @@ title: Fiscal Data Package
- Author(s) |
+ Authors |
Paul Walsh, Rufus Pollock, Tryggvi Björgvinsson, Steve Bennett, Adam Kariv, Dan Fowler |
diff --git a/content/docs/extensions/tabular-data-package.md b/content/docs/extensions/tabular-data-package.md
index d8de69cb..e3bed946 100644
--- a/content/docs/extensions/tabular-data-package.md
+++ b/content/docs/extensions/tabular-data-package.md
@@ -4,7 +4,7 @@ title: Tabular Data Package
- Author(s) |
+ Authors |
Paul Walsh, Rufus Pollock, Martin Keegan |
diff --git a/content/docs/extensions/tabular-data-resource.md b/content/docs/extensions/tabular-data-resource.md
index 573ec4a9..3881a304 100644
--- a/content/docs/extensions/tabular-data-resource.md
+++ b/content/docs/extensions/tabular-data-resource.md
@@ -4,7 +4,7 @@ title: Tabular Data Resource
- Author(s) |
+ Authors |
Paul Walsh, Rufus Pollock |
diff --git a/content/docs/recipes/caching-of-resources.md b/content/docs/recipes/caching-of-resources.md
index 57dbccc2..c84ef76d 100644
--- a/content/docs/recipes/caching-of-resources.md
+++ b/content/docs/recipes/caching-of-resources.md
@@ -2,6 +2,13 @@
title: Caching of Resources
---
+
+
All Frictionless Data specifications allow for referencing resources via http or a local filesystem.
In the case of remote resources via http, there is always the possibility that the remote server will be unavailable, or, that the resource itself will be temporarily or permanently removed.
diff --git a/content/docs/recipes/compression-of-resources.md b/content/docs/recipes/compression-of-resources.md
index 748e9738..05d29aec 100644
--- a/content/docs/recipes/compression-of-resources.md
+++ b/content/docs/recipes/compression-of-resources.md
@@ -2,6 +2,13 @@
title: Compression of Resources
---
+
+
It can be argued that applying compression to data resources can make data package publishing more cost-effective and sustainable. Compressing data resources gives publishers the benefit of reduced storage and bandwidth costs and gives consumers the benefit of shorter download times.
## Implementations
diff --git a/content/docs/recipes/data-catalog.md b/content/docs/recipes/data-catalog.md
index eeeb910b..6da7aea9 100644
--- a/content/docs/recipes/data-catalog.md
+++ b/content/docs/recipes/data-catalog.md
@@ -2,6 +2,13 @@
title: Data Catalog
---
+
+
There are scenarios where one needs to describe a collection of data packages, such as when building an online registry, or when building a pipeline that ingests multiple datasets.
In these scenarios, the collection can be described using a "Catalog", where each dataset is represented as a single resource which has:
diff --git a/content/docs/recipes/data-dependencies.md b/content/docs/recipes/data-dependencies.md
index 4da25a87..eabefb9d 100644
--- a/content/docs/recipes/data-dependencies.md
+++ b/content/docs/recipes/data-dependencies.md
@@ -2,6 +2,13 @@
title: Data Dependencies
---
+
+
Consider a situation where data packages are part of a tool chain that, say, loads all of the data into an SQL db. You can then imagine a situation where one requires package A which requires package B + C.
In this case you want to specify that A depends on B and C -- and that "installing" A should install B and C. This is the purpose of `dataDependencies` property.
diff --git a/content/docs/recipes/data-package-version.md b/content/docs/recipes/data-package-version.md
index 89e57594..152fdbf9 100644
--- a/content/docs/recipes/data-package-version.md
+++ b/content/docs/recipes/data-package-version.md
@@ -2,6 +2,13 @@
title: Data Package Version
---
+
+
## Specification
The Data Package version format follows the [Semantic Versioning](http://semver.org) specification format: MAJOR.MINOR.PATCH
diff --git a/content/docs/recipes/enum-labels-and-ordering.md b/content/docs/recipes/enum-labels-and-ordering.md
index 27f9086a..c62dcb70 100644
--- a/content/docs/recipes/enum-labels-and-ordering.md
+++ b/content/docs/recipes/enum-labels-and-ordering.md
@@ -2,6 +2,13 @@
title: Enum Labels and Ordering
---
+
+
## Overview
Many software packages for manipulating and analyzing tabular data have special
diff --git a/content/docs/recipes/external-foreign-keys.md b/content/docs/recipes/external-foreign-keys.md
index 7c9ccc04..41287dfc 100644
--- a/content/docs/recipes/external-foreign-keys.md
+++ b/content/docs/recipes/external-foreign-keys.md
@@ -2,6 +2,13 @@
title: External Foreign Keys
---
+
+
A foreign key is a reference where values in a field (or fields) in a Tabular Data Resource link to values in a field (or fields) in a Tabular Data Resource in the same or in another Tabular Data Package.
This pattern allows users to link values in a field (or fields) in a Tabular Data Resource to values in a field (or fields) in a Tabular Data Resource in a different Tabular Data Package.
diff --git a/content/docs/recipes/json-data-resources.md b/content/docs/recipes/json-data-resources.md
index 36cc713a..f943fdab 100644
--- a/content/docs/recipes/json-data-resources.md
+++ b/content/docs/recipes/json-data-resources.md
@@ -2,6 +2,13 @@
title: JSON Data Resources
---
+
+
A simple format to describe a single structured JSON data resource. It includes support both for metadata such as author and title and a [schema](https://json-schema.org/) to describe the data.
## Introduction
diff --git a/content/docs/recipes/language-support.md b/content/docs/recipes/language-support.md
index d26b7a18..cd220755 100644
--- a/content/docs/recipes/language-support.md
+++ b/content/docs/recipes/language-support.md
@@ -2,6 +2,13 @@
title: Language Support
---
+
+
Language support is a different concern to translation support. Language support deals with declaring the default language of a descriptor and the data it contains in the resources array. Language support makes no claim about the presence of translations when one or more languages are supported in a descriptor or in data. Via the introduction of a `languages` array to any descriptor, we can declare the default language, and any other languages that `SHOULD` be found in the descriptor and the data.
## Implementations
diff --git a/content/docs/recipes/metadata-in-table-schema.md b/content/docs/recipes/metadata-in-table-schema.md
index 43266138..e8a72fb6 100644
--- a/content/docs/recipes/metadata-in-table-schema.md
+++ b/content/docs/recipes/metadata-in-table-schema.md
@@ -2,6 +2,13 @@
title: Metadata in Table Schema
---
+
+
## Overview
Table Schemas need their own metadata to be stand-alone and interpreted without relying on other contextual information (Data Package metadata for example). Adding metadata to describe schemas in a structured way would help users to understand them and would increase their sharing and reuse.
diff --git a/content/docs/recipes/nested-resources.md b/content/docs/recipes/nested-resources.md
index a4212b30..a1ef45ac 100644
--- a/content/docs/recipes/nested-resources.md
+++ b/content/docs/recipes/nested-resources.md
@@ -2,6 +2,13 @@
title: Nested Resources
---
+
+
Some datasets need to contain a Zip file (or tar, other formats) containing a
set of files.
diff --git a/content/docs/recipes/private-properties.md b/content/docs/recipes/private-properties.md
index 41be6923..14a86958 100644
--- a/content/docs/recipes/private-properties.md
+++ b/content/docs/recipes/private-properties.md
@@ -2,8 +2,12 @@
title: Private Properties
---
-[issues]: https://github.com/frictionlessdata/specs/issues
-[repo]: https://github.com/frictionlessdata/specs
+
Some software that implements the Frictionless Data specifications may need to store additional information on the various Frictionless Data descriptors.
diff --git a/content/docs/recipes/translation-support.md b/content/docs/recipes/translation-support.md
index 6c73762e..8fbfc395 100644
--- a/content/docs/recipes/translation-support.md
+++ b/content/docs/recipes/translation-support.md
@@ -2,6 +2,13 @@
title: Translation Support
---
+
+
Following on from a general pattern for language support, and the explicit support of metadata translations in Frictionless Data descriptors, it would be desirable to support translations in source data.
We currently have two patterns for this in discussion. Both patterns arise from real-world implementations that are not specifically tied to Frictionless Data.
diff --git a/content/docs/specifications/data-package.md b/content/docs/specifications/data-package.md
index 32f98b1f..bd8e8349 100644
--- a/content/docs/specifications/data-package.md
+++ b/content/docs/specifications/data-package.md
@@ -6,7 +6,7 @@ sidebar:
- Author(s) |
+ Authors |
Paul Walsh, Rufus Pollock |
diff --git a/content/docs/specifications/data-resource.md b/content/docs/specifications/data-resource.md
index fbad99f8..8d4b41f9 100644
--- a/content/docs/specifications/data-resource.md
+++ b/content/docs/specifications/data-resource.md
@@ -6,7 +6,7 @@ sidebar:
- Author(s) |
+ Authors |
Paul Walsh, Rufus Pollock |
diff --git a/content/docs/specifications/extensions.md b/content/docs/specifications/extensions.md
index 3beee99a..d913d77f 100644
--- a/content/docs/specifications/extensions.md
+++ b/content/docs/specifications/extensions.md
@@ -1,6 +1,7 @@
---
title: Extensions
sidebar:
+ hidden: true
order: 5
---
diff --git a/content/docs/specifications/glossary.md b/content/docs/specifications/glossary.md
index 546541f2..400ff7fd 100644
--- a/content/docs/specifications/glossary.md
+++ b/content/docs/specifications/glossary.md
@@ -1,9 +1,17 @@
---
title: Glossary
sidebar:
+ hidden: true
order: 6
---
+
+
+ Authors |
+ Paul Walsh, Rufus Pollock |
+
+
+
A dictionary of special terms for the Data Package Standard.
## Language
diff --git a/content/docs/specifications/security.md b/content/docs/specifications/security.md
index 41644b13..35f6d04d 100644
--- a/content/docs/specifications/security.md
+++ b/content/docs/specifications/security.md
@@ -6,7 +6,7 @@ sidebar:
- Author(s) |
+ Authors |
Johannes Jander |
diff --git a/content/docs/specifications/table-dialect.md b/content/docs/specifications/table-dialect.md
index d6bd2adc..b2ab1b64 100644
--- a/content/docs/specifications/table-dialect.md
+++ b/content/docs/specifications/table-dialect.md
@@ -6,7 +6,7 @@ sidebar:
- Author(s) |
+ Authors |
Rufus Pollock |
diff --git a/content/docs/specifications/table-schema.md b/content/docs/specifications/table-schema.md
index fe46c212..6597c349 100644
--- a/content/docs/specifications/table-schema.md
+++ b/content/docs/specifications/table-schema.md
@@ -6,7 +6,7 @@ sidebar:
- Author(s) |
+ Authors |
Paul Walsh, Rufus Pollock |