You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@solr.apache.org by "Cassandra Targett (Jira)" <ji...@apache.org> on 2021/07/21 19:00:03 UTC
[jira] [Created] (SOLR-15556) Ref Guide Redesign Phase 3: Replace
Jekyll
Cassandra Targett created SOLR-15556:
----------------------------------------
Summary: Ref Guide Redesign Phase 3: Replace Jekyll
Key: SOLR-15556
URL: https://issues.apache.org/jira/browse/SOLR-15556
Project: Solr
Issue Type: Improvement
Security Level: Public (Default Security Level. Issues are Public)
Components: documentation
Reporter: Cassandra Targett
Assignee: Cassandra Targett
The final step of my grand vision for redesigning the Ref Guide is to look at replacing Jekyll with a different static site generator.
The primary reason why is because Jekyll is designed for blog posts, not for sites with hundreds of static pages like ours. Back in 2017 when I chose it, it was relatively straightforward to implement, a lot of information was available in Jekyll docs and the internet in general to customize it, and it was one of the few that supported Asciidoc format.
However now there are a lot more options, including some which are specifically designed for large multi-version documentation sites like the Ref Guide.
Included with this will be reorganizing the on-disk organization of the ref guide files themselves.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org