process and markdown "ready"
diff --git a/docs/ezt.md b/docs/ezt.md
deleted file mode 100644
index 58b4779..0000000
--- a/docs/ezt.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## EZT
-
-File extension for ezt templates translating into Markdown/HTML which generates html is **ezmd**.
-
-Pages may be [ezt][1] templates that create Markdown output
-
-- [ezt Syntax][2]
-
-- www-site examples
-
- - [export notifications][3] shows creating markdown.
- - [main page][4] has several html examples. The location may change, look for `pl_`.
- - [foundation page's pmc chair list][5]. The location may change, look for `projects.site`.
- - [simple board list][6].
-
-
-[1]: https://github.com/gstein/ezt
-[2]: https://github.com/gstein/ezt/blob/wiki/Syntax.md
-[3]: https://github.com/apache/www-site/blob/main/content/licenses/exports/index.ezmd
-[4]: https://github.com/apache/www-site/blob/main/content/index.ezmd#L382
-[5]: https://github.com/apache/www-site/blob/main/content/foundation/index.ezmd#L140
-[6]: https://github.com/apache/www-site/blob/main/content/foundation/board/index.ezmd
diff --git a/docs/markdown.md b/docs/markdown.md
index 554b4dd..ec66d01 100644
--- a/docs/markdown.md
+++ b/docs/markdown.md
@@ -1,14 +1,16 @@
# Gihub Flavored Markdown (GFM)
+Content is in [GitHub Flavored Markdown][3] (GFM).
+
File extensions are **md**, **markdown**, **mkd**, and **mdown**. If you have an **mdtext** file it is from the Apache CMS.
-This site uses a version of [cmark-gfm][1] by [GitHub][2] through a Pelican Plugin *gfm.py* created by Apache Infra.
+The site uses a version of [cmark-gfm][1] by [GitHub][2] through a Pelican Plugin *gfm.py* created by Apache Infra.
- [Mastering Markdown][3]
- [Detailed Specification][4]
-- Differences from markdown.pl
+- Some differences from `markdown.pl` used in the Apache CMS.
- [HTML Blocks][5]
- Make sure the first line of your html block starts in column one.
@@ -25,6 +27,33 @@
- [Examples][13]
+- ID and Class Annotations
+
+```md
+## What is the Apache Software Foundation? {#what}
+
+The Apache Software Foundation (ASF) is a non-profit 501(c)(3) corporation,
+incorporated in Delaware, USA, in June of 1999. The ASF is a natural
+outgrowth of The Apache Group, which
+formed in 1995 to develop the Apache HTTP Server.
+```
+
+Set the class to display an image to `float-right`
+
+```md
+![Logo](images/logo.svg) {.float-right}
+```
+
+An HTML fragment is also feasible for a similar purpose
+
+```html
+<div class=".pull-right" style="float:right; border-style:dotted; width:200px; padding:5px; margin:5px">
+
+SEE INSTEAD: [Trademark Resources Site Map][resources].
+
+</div>
+```
+
- Apache CMS Migration
- Change extension from **mdtext** to **md**
diff --git a/docs/process.md b/docs/process.md
index 79089e1..2107110 100644
--- a/docs/process.md
+++ b/docs/process.md
@@ -1,4 +1,4 @@
-# Pelican Builds
+# Pelican Build Process
This website is built using [Pelican][pelican]. Configure the build using the [pelicanconf.py][configure] settings.
@@ -67,7 +67,23 @@
| | [Translate][ezttranslate] | | ezt | ezt template translation |
| | [Render GFM][markdown] | render | super.render | render GFM/HTML into HTML |
| Content | [Generate ID][asfgenid] | generate_id | generate_id | Perform ASF specific HTML enhancements |
-| Generator | [Template][templates] | translate | translate | Create output HTML by pushing the generated content and metadata through the theme's templates |
+| Generator | [Template][theme] | translate | translate | Create output HTML by pushing the generated content and metadata through the theme's templates |
+
+See [local builds][local] for how to install [Pelican ASF][pelicanasf] on your system.
+
+## Data Model
+
+A shared metadata model is used by **ezmd** templates to generate content. There are three types of data:
+
+| When refereced | Data Type |
+|-----------------|----------------------------------|
+| EZMD Reader, Content, Generator | Constants - either integer or string values |
+| EZMD Reader | Sequences - arrays of objects with attributes where an attribute may be another sequence |
+| EZMD Reader | Dictionaries - key-value maps where the value may be another dictionary |
+
+The constants are also available to the [`asfgenid.py`][asfgenid] plugin and the [theme's templates][theme].
+
+There are examples of how to [inject shared metadata below][metadata]. See [metadata model][data] for how `asfdata.py` works to populate the shared metadata.
## Read Source
@@ -189,7 +205,7 @@
## EZT Translation
-**ezmd* Pages files are [ezt][ezt] templates that create Markdown and HTML output. See [EZT Syntax][eztsyntax] for the directives.
+**ezmd** Pages files are [ezt][ezt] templates that create Markdown and HTML output. See [EZT Syntax][eztsyntax] for the directives.
### EZT Examples
@@ -400,17 +416,6 @@
headingid_transform(ids, soup, tag, asf_genid['permalinks'], permalinks)
```
-## Data
-
-- [Preview Branching](branches.md)
- How to work on complex changes like updated templates, new data sources, and alternative content.
-
-- Local Builds
- How to set up your local environment to work on a branch.
-
-- Error Analysis
- How to find errors in your build.
-
[pelican]: https://blog.getpelican.com
[mastering]: https://guides.github.com/features/mastering-markdown/
@@ -445,11 +450,10 @@
[read]: #read-source
[metadata]: #model-metadata
[markdown]: #render-gfm
-[data]: #data
+[data]: data.md
[ezttranslate]: #ezt-translation
[process]: #process
[branches]: #branches
-[local]: #local
+[local]: builds.md
[asfref]: #reference
-[templates]: #templates
[pelican-gfm]: #pelican-gfm