[lucene] 10/11: we never use the [options="header"] layout, so document what we do use

[dw...@apache.org]

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

dweiss pushed a commit to branch SOLR-14866
in repository https://gitbox.apache.org/repos/asf/lucene.git

commit b39d03f044a46cd67b8be32338f23f8f139ec0ef
Author: epugh <ep...@opensourceconnections.com>
AuthorDate: Thu Sep 17 16:59:33 2020 -0400

    we never use the [options="header"] layout, so document what we do use
---
 solr/solr-ref-guide/src/meta-docs/asciidoc-syntax.adoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/solr/solr-ref-guide/src/meta-docs/asciidoc-syntax.adoc b/solr/solr-ref-guide/src/meta-docs/asciidoc-syntax.adoc
index 36f9b1a..428512a 100644
--- a/solr/solr-ref-guide/src/meta-docs/asciidoc-syntax.adoc
+++ b/solr/solr-ref-guide/src/meta-docs/asciidoc-syntax.adoc
@@ -302,11 +302,11 @@ The basic structure of a table is similar to Markdown, with pipes (`|`) delimiti
 Note the use of `|===` at the start and end. For basic tables that's not exactly required, but it does help to delimit the start and end of the table in case you accidentally introduce (or maybe prefer) spaces between the rows.
 
 === Header Rows
-To add a header to a table, you need only set the `header` attribute at the start of the table:
+Most of our tables are laid out with a header and spread out to the width of the page, so you will see this header definition frequently:
 
 [source]
 ----
-[options="header"]
+[%autowidth.spread,width="100%",options="header"]
 |===
 | header col 1 | header col 2|
 | col 1 row 1 | col 2 row 1|