[
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: [email protected]
For additional commands, e-mail: [email protected]