[drill] branch gh-pages updated (07b1902 -> 571cba8)

[dz...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

dzamo pushed a change to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/drill.git.


    from 07b1902  [DOC UPDATE] Fix invalid link for 110-troubleshooting.md (#2161)
     new 1f1a7e8  Correct typos in 060-querying-the-information-schema.md
     new f5f4d2f  Fix Drill output formatting in 053-describe.md
     new ad62f65  Add links to Slack channels to menu bar and selected pages.
     new bdc00b6  Add 030-rdbms-metastore.md
     new b9af195  Convert <span>s to <a>s in 110-troubleshooting.md to make them linkable.
     new 27a2a57  Document the ElasticSearch storage plugin.
     new 571cba8  Update README.md to reflect new docs software versions.

The 7 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 README.md                                          |  22 ++-
 _data/docs.json                                    | 120 +++++++++++--
 _docs/110-troubleshooting.md                       |   6 +-
 .../plugins/130-elasticsearch.md                   |  55 ++++++
 ...metastore.md => 020-drill-iceberg-metastore.md} |   0
 .../drill-metastore/030-rdbms-metastore.md         | 161 +++++++++++++++++
 .../060-querying-the-information-schema.md         |  13 +-
 _docs/sql-reference/sql-commands/053-describe.md   | 199 +++++++++++----------
 _includes/menu.html                                |   4 +-
 _sass/_site-main.scss                              |   7 +-
 community-resources.md                             |   3 +-
 images/slack-logo.svg                              |  99 ++++++++++
 poweredBy.html                                     |   4 +-
 13 files changed, 555 insertions(+), 138 deletions(-)
 create mode 100644 _docs/connect-a-data-source/plugins/130-elasticsearch.md
 rename _docs/performance-tuning/drill-metastore/{030-drill-iceberg-metastore.md => 020-drill-iceberg-metastore.md} (100%)
 create mode 100644 _docs/performance-tuning/drill-metastore/030-rdbms-metastore.md
 create mode 100644 images/slack-logo.svg

[drill] 07/07: Update README.md to reflect new docs software versions.

[dz...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

dzamo pushed a commit to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/drill.git

commit 571cba89aa9f77cc63db8b9adbe84395b2b12f49
Author: James Turton <ja...@somecomputer.xyz>
AuthorDate: Mon Feb 15 14:56:13 2021 +0200

    Update README.md to reflect new docs software versions.
---
 README.md | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 30e496c..3f2df7d 100644
--- a/README.md
+++ b/README.md
@@ -2,29 +2,35 @@ The Apache Drill website is built using [Jekyll](http://jekyllrb.com/).
 
 # Configuring env
 1. Install `ruby`
-2. Install `bundler` and `jekyll` `v2.5.2`:
+2. Install `bundler` and `jekyll` `v3.9.0`:
 ```
-gem install bundler jekyll:2.5.2
+gem install bundler jekyll:3.9.0
 ```
 3. Install `jekyll-redirect-from` `v0.9.1`:
 ```
 gem install jekyll-redirect-from:0.9.1
 ```
-4. Install Python v2.7.15.
+4. Install Python 3
 
 Please make sure that specific versions of libraries are installed since building the site with other versions may cause some issues like including md document index into the references, etc.
 
+## Note for existing contributors
+The software version numbers above underwent a major increase in 2020 and the Markdown processor
+changed from Redcarpet to Kramdown.  Please check the versions in your environment if you're having
+trouble generating the site.
+
 # Documentation Guidelines
 
-The documentation pages are placed under `_docs`. You can modify existing .md files, or you can create new .md files to add to the Apache Drill documentation site. Create pull requests to submit your documentation updates. The Kramdown MarkDown processor employed by Jekyll supports [a dialect of MarkDown](https://kramdown.gettalong.org/quickref.html) which is a superset of standard MarkDown.
+The documentation pages are placed under `_docs`. You can modify existing .md files, or you can create new .md files to add to the Apache Drill documentation site. Create pull requests to submit your documentation updates. The Kramdown Markdown processor employed by Jekyll supports [a dialect of Markdown](https://kramdown.gettalong.org/quickref.html) which is a superset of standard Markdown.
 
-## Creating New MarkDown Files
+## Creating New Markdown Files
 
-If you create new MarkDown (.md) files, include the required YAML front matter and name the file using the methods described in this section. 
+If you create new Markdown (.md) files, include the required YAML front matter and name the file using the methods described in this section. 
 
 The YAML front matter has three important parameters:
 
 * `title:` - This is the title of the page enclosed in quotation marks. Each page must have a *unique* title
+* `slug:` - Set this to the same value as `title`, it will be slugified automatically by Jekyll.
 * `date:` - This field is needed for Jekyll to write a last-modified date. Initially, leave this field blank.
 * `parent:` - This is the title of the page's parent page. It should be empty for top-level sections/guides, and be identical to the title attribute of another page in all other cases.
 
@@ -33,7 +39,7 @@ The name of the file itself doesn't matter except for the alphanumeric order of
 Best practices:
 
 * Prefix the filenames with `010-foo.md`, `020-bar.md`, `030-baz.md`, etc. This allows room to add files in-between (eg, `005-qux.md`).  
-* Use the slug of the title as the filename. For example, if the title is "Getting Started with Drill", name the file `...-getting-started-with-drill.md`. If you're not sure what the slug is, you should be able to see it in the URL and then adjust (the URLs are auto-generated based on the title attribute).
+* Use the slugified title as the filename. For example, if the title is "Getting Started with Drill", name the file `...-getting-started-with-drill.md`. If you're not sure what the slug is, you should be able to see it in the URL and then adjust (the URLs are auto-generated based on the title attribute).
 
 # Developing and Previewing the Website
 
@@ -42,7 +48,7 @@ To preview the website on your local machine:
 ```bash
 jekyll build --config _config.yml,_config-prod.yml
 _tools/createdatadocs.py
-jekyll serve --config _config.yml,_config-prod.yml
+jekyll serve --config _config.yml,_config-prod.yml [--livereload] [--incremental]
 ```
 Note that you can skip the first two commands (and only run `jekyll serve`) if you haven't changed the title or path of any of the documentation pages.
 

[drill] 05/07: Convert s to s in 110-troubleshooting.md to make them linkable.