[ https://issues.apache.org/jira/browse/LUCENE-9459?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17188260#comment-17188260 ]
Tomoko Uchida commented on LUCENE-9459: --------------------------------------- Hi [~lmenezes], thanks for paying attention for this. I have not yet done anything here. I think we may have {{lucene/luke/docs}} folder and put all Markdown (this is standard documentation format in Lucene) and image files under it. It could look like this: {code:sh} lucene/luke/ ├── bin ├── build.gradle ├── docs # add this folder │ ├── getting-started.md │ └── image ├── lib └── src {code} Once you have done the most important part (preparing the content), we can work together for packaging/publishing stuff (converting Markdown to HTML/Asciidoc, make it a part of Lucene/Solr documentation). > "Getting Started" guide for Luke > --------------------------------- > > Key: LUCENE-9459 > URL: https://issues.apache.org/jira/browse/LUCENE-9459 > Project: Lucene - Core > Issue Type: Improvement > Components: modules/luke > Reporter: Tomoko Uchida > Priority: Major > Labels: newdev > > While Luke has been very popular, widely accepted tool to Lucene users > (including Solr and Elasticsearch users) for 10+ years, it lacks good > documentation and/or user guide. Although Luke is a GUI tool that describes > itself, it's not good for new users. > The lack of documentation is partly due to my laziness though, there is some > inherent difficulty of explaining such low-level tool; if you don't know > Lucene you don't understand Luke's capability or usefulness, if you once > understand Lucene at some level, it's obvious to you and no explanation is > needed. :) > Nonetheless, it would be great if we have "Getting Started" documentation for > Luke on our web site for new users/devs. > We may be able to have a Markdown file with some screenshots and usage > descriptions, then convert it to HTML by Gradle task, so that we can publish > it with whole API documentation. -- This message was sent by Atlassian Jira (v8.3.4#803005) --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org For additional commands, e-mail: issues-h...@lucene.apache.org