[ https://issues.apache.org/jira/browse/SOLR-10301?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16093625#comment-16093625 ]
Cassandra Targett commented on SOLR-10301: ------------------------------------------ bq. as a straw man alternative ... [etc.] I like the idea, but I couldn't figure out how to do it without modifying the code that builds that sidenav and I didn't want to bother you ;) I also rather like having the pages all together for now. Maybe once it's out there users will want them separated. bq. we wouldn't need to rely on format conditional logic – which might reduce confusion for folks who edit these pages? (just hypothosizing) I hope it's not confusing, but I guess it could be. I'll add comments to make it clear why those sections are like that. They are fortunately rather short so it's easy to see where they begin and end. > Create meta-documentation for how to write in asciidoc > ------------------------------------------------------ > > Key: SOLR-10301 > URL: https://issues.apache.org/jira/browse/SOLR-10301 > Project: Solr > Issue Type: Sub-task > Security Level: Public(Default Security Level. Issues are Public) > Components: documentation > Reporter: Cassandra Targett > Assignee: Cassandra Targett > > If we want to encourage new users and non-committers to contribute patches > for the Ref Guide, we should document some basics on how to write in > Asciidoc(tor) format, and how to install/use various tools to improve the > experience. > Some basic style guidelines may also be helpful, to ensure a consistent > experience once docs are published. -- This message was sent by Atlassian JIRA (v6.4.14#64029) --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@lucene.apache.org For additional commands, e-mail: dev-h...@lucene.apache.org