[ https://issues.apache.org/jira/browse/SOLR-15556?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17390702#comment-17390702 ]
David Eric Pugh commented on SOLR-15556: ---------------------------------------- I can see some "pros" for having example code that is validated using our unit test framework that doesn't actually have to be PRIMARILY a unit test. I remember when working with some of the sample code for scripting contrib that I might have made it more verbose to explain what it did, but that felt odd to do in a unit test... I do LOVE that the included sample code is actually runnable tested code. I'd love to extend that to the various sample code for streaming some day. > 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 > Priority: Major > > 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-unsubscr...@solr.apache.org For additional commands, e-mail: issues-h...@solr.apache.org