samredai commented on a change in pull request #59:
URL: https://github.com/apache/iceberg-docs/pull/59#discussion_r813154869



##########
File path: README.md
##########
@@ -31,20 +31,30 @@ The Javadocs are in the `./javadoc` directory.
 
 ## Relationship to the Iceberg Repository
 
-The `documentation` folder in the [Iceberg 
repository](https://github.com/apache/iceberg) contains all the markdown docs 
used by the website.
-The `common` subfolder contains contents used by the landing page.
-The `versioned` subfolder contains the contents different for each version.
+All markdown pages that are part of a versioned released are maintained in the 
iceberg repository. All pages common across all version releases are
+kept here in the iceberg-docs repo. A few exceptions are the markdown files 
that can be found in the `format` folder in the iceberg repository and contains
+markdown files that are copied to `./landing-page/content/common/format`.
+
+`apache/iceberg`
+- The `docs` folder in the [Iceberg 
repository](https://github.com/apache/iceberg) contains all the markdown docs 
used by the **versioned** docs site.
+- The `format` folder contains some items that are common accross all 
versions, such as the Iceberg format specification.

Review comment:
       Fixed!




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to