[solr] branch main updated: Fix solr-ref-guide/README.adoc (#231)

[ct...@apache.org]

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

ctargett pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/solr.git


The following commit(s) were added to refs/heads/main by this push:
     new 6668d1f  Fix solr-ref-guide/README.adoc (#231)
6668d1f is described below

commit 6668d1f4926190267d7bf837ce297166c89b6fa7
Author: Cassandra Targett <ct...@apache.org>
AuthorDate: Wed Jul 21 15:16:35 2021 -0500

    Fix solr-ref-guide/README.adoc (#231)
---
 solr/solr-ref-guide/README.adoc | 44 +++--------------------------------------
 1 file changed, 3 insertions(+), 41 deletions(-)

diff --git a/solr/solr-ref-guide/README.adoc b/solr/solr-ref-guide/README.adoc
index 010079e..c82f286 100644
--- a/solr/solr-ref-guide/README.adoc
+++ b/solr/solr-ref-guide/README.adoc
@@ -20,45 +20,7 @@ This is the source for the Solr Reference Guide.
 
 Raw content is stored in Asciidoc (`.adoc`) formatted files in the `src/` directory.
 
-== Prerequisites for Building
-These files are processed with AsciiDoctor in 2 different ways:
+To build the Ref Guide, simply run `./gradlew checkSite`.
+This will build the HTML files and validate that page references and internal links work properly.
 
-* HTML version, using Jekyll:
-** `Ruby` (v2.3 or higher)
-** The following gems must be installed:
-*** `jekyll`: v3.5, not v4.x.
-Use `gem install jekyll --force --version 3.5.0` to force install of v3.5.0.
-*** `jekyll-asciidoc`: v2.1 or higher; latest version (3.0.0) is fine.
-Use `gem install jekyll-asciidoc` to install.
-*** `slim`: v3.0 or higher; latest version (4.0.1) is fine.
-Use `gem install slim` to install.
-*** `tilt`: v1.0 or higher; latest version (2.0.10) is fine.
-Use `gem install tilt` to install.
-*** `concurrent-ruby`: v1.0 or higher; latest version (1.1.5) is fine.
-Use `gem install concurrent-ruby` to install.
-
-
-== Building the Guide
-For details on building the ref guide, see `gradlew tasks`, the `Documentation Tasks` section.
-
-There are currently four available targets:
-
-* `gradlew buildSite`: Builds an HTML Site w/Jekyll and verifies the anchors+links are valid
-* `gradlew documentation`: Generate all documentation
-* `gradlew javadoc`: Generates Javadoc API documentation for the main source code.
-* `gradlew renderJavadoc`: Generates Javadoc API documentation for the main source code. This directly invokes javadoc tool.
-* `gradlew renderSiteJavadoc`: Generates Javadoc API documentation for the site (relative links).
-
-The output of all builds will be located in `../solr-ref-guide/build`.
-
-== Key Directories
-Key directories to be aware of:
-
-* `src` - where all human edited `*.adoc` files related to the Guide live, as well as various configuration, theme, and template files.
-* `tools` - custom Java code for parsing metadata in our `src/*.adoc` files to produce some `_data/` files for site navigation purposes.
-* `../solr-ref-guide/build/content` - a copy of the `src` dir generated by gradle where:
-** `*.template` files are processed to replace gradle (TODO CHECK!) properties with their runtime values
-** some `../solr-ref-guide/build/content/_data` files are generated by our java tools based header attributes from each of the `*.adoc` files
-* `../solr-ref-guide/build/html-site` - HTML generated version of the ref guide
-
-See the additional documentation in `src/meta-docs` for more information about how to edit files, build for releases, or modifying any Jekyll templates.
+See the `../../dev-docs/ref-guide` directory for information about editing and publishing the Ref Guide.