Hi Michael, it looks fine to me; thanks for considering my suggestions. It seems better to move the conversation to github; once you make a PR I'll take care of it.
Tomoko 2021年5月10日(月) 19:24 Michael Wechner <[email protected]>: > Hi Together > > I have made a draft of the README (including logos/images) at > > https://github.com/wyona/apache-lucene-luke > > Let me know what you think and I can copy it to > > https://github.com/apache/lucene/tree/main/lucene/luke > > and make a PR. > > Thanks > > Michael > > > > Am 04.05.21 um 07:15 schrieb Dmitry Kan: > > Hello! > > Glad to see some docs Tomoko and I wrote years ago turned out be useful > and on the way to Lucene's docs -- just a suggestion, that you could also > have a link to older (pre 8.x) releases of luke, as it may well be there > are users for those versions? > > https://github.com/DmitryKey/luke/releases > > Best, > > Dmitry > > On Sun, 2 May 2021 at 10:48, Tomoko Uchida <[email protected]> > wrote: > >> Please feel free to make a PR if you'd like (with a Jira isssue could be >> better). >> I just wanted to leave some comments about the contents. >> >> > - About Luke >> This would still makes sense to copy it to Lucene repo to me. >> >> > - Launching Luke >> This section has been outdated except for step 3. >> >> > - Search engines luke can deal with >> Personally I don't think we should mention/emphasize specific 3rd party >> projects on our official website. >> >> > - Brief project history >> This section is already included in Luke itself - its "About" dialog. >> >> Tomoko >> >> >> 2021年5月2日(日) 15:20 Michael Wechner <[email protected]>: >> >>> I would like to suggest, that we only copy the content from >>> https://github.com/DmitryKey/luke#important-notice which still makes >>> sense, like for example >>> >>> - About Luke >>> - Launching Luke >>> - Search engines luke can deal with >>> - Brief project history >>> >>> WDYT? >>> >>> I can do this if nobody else has time, whereas let me know, so that we >>> don't do the same thing twice :-) >>> >>> Thanks >>> >>> Michael >>> >>> Am 01.05.21 um 17:53 schrieb Tomoko Uchida: >>> >>> I just partially backported the patch on the 8x branch. See the issue >>> how it looks like. >>> https://issues.apache.org/jira/browse/LUCENE-9947 >>> >>> > Should I make a PR? If we use the markdown files from the old GitHub >>> Location, we can easily publish them as part of official documentation. >>> >>> Thank you Uwe. But I don't think it is very much meaningful to just copy >>> the old repository's README or docs to our site. They are almost filled >>> with its historical notes and outdated information. >>> >>> Tomoko >>> >>> >>> 2021年5月2日(日) 0:38 Uwe Schindler <[email protected]>: >>> >>>> Should I make a PR? If we use the markdown files from the old GitHub >>>> Location, we can easily publish them as part of official documentation. The >>>> correct module is below lucene/documentation. >>>> >>>> Uwe >>>> >>>> Am May 1, 2021 3:10:22 PM UTC schrieb Tomoko Uchida < >>>> [email protected]>: >>>>> >>>>> > Do you think it would still make sense to add some documentation as >>>>> well to >>>>> > https://github.com/apache/lucene/tree/main/lucene/luke >>>>> >>>>> Yes, my PR is orthogonal to the suggestion. >>>>> >>>>> Just to make things a little clear, the README file under the module >>>>> directory won't be published as the part of the official documentation >>>>> (Lucene website). >>>>> Related to Uwe's suggestion, we have an issue for Luke documentation. >>>>> If you're really interested in making changes on official documentation as >>>>> you firstly mentioned, feel free to involve it; but I think it would need >>>>> a >>>>> bit of work. >>>>> https://issues.apache.org/jira/browse/LUCENE-9459 >>>>> >>>>> Tomoko >>>>> >>>>> >>>>> 2021年5月1日(土) 23:42 Michael Wechner <[email protected]>: >>>>> >>>>>> ah ok :-) >>>>>> >>>>>> Do you have an idea when 9.0 will be released approximately? >>>>>> >>>>>> Do you think it would still make sense to add some documentation as >>>>>> well to >>>>>> >>>>>> https://github.com/apache/lucene/tree/main/lucene/luke >>>>>> >>>>>> ? >>>>>> >>>>>> Thanks >>>>>> >>>>>> Michael >>>>>> >>>>>> Am 01.05.21 um 16:38 schrieb Tomoko Uchida: >>>>>> >>>>>> The documentation is frozen when it is released (it's part of the >>>>>> release package). >>>>>> >>>>>> https://github.com/apache/lucene/pull/120 was merged into the main >>>>>> branch, so it will be shipped with 9.0 - the next major release. >>>>>> Unfortunately I think it wouldn't be trivial to backport the >>>>>> documentation change into the branch for 8.x. >>>>>> >>>>>> Tomoko >>>>>> >>>>>> >>>>>> 2021年5月1日(土) 23:04 Michael Wechner <[email protected]>: >>>>>> >>>>>>> I am lIttle confused now :-) where exactly are these changes now? >>>>>>> >>>>>>> If I understand correctly that PR has already been merged ( >>>>>>> https://github.com/apache/lucene/pull/120), but I cannot see the >>>>>>> changes at >>>>>>> >>>>>>> https://lucene.apache.org/core/8_8_2/index.html >>>>>>> https://lucene.apache.org/core/8_8_2/luke/index.html >>>>>>> >>>>>>> Thanks >>>>>>> >>>>>>> Michael >>>>>>> >>>>>>> Am 01.05.21 um 11:15 schrieb Tomoko Uchida: >>>>>>> >>>>>>> Just FYI, we're going to remove Javadocs for luke module from the >>>>>>> documentation site (it does not much make sense publishing API docs for >>>>>>> the >>>>>>> GUI tool anyway). >>>>>>> Instead, I've added a simple description about how to launch the app. >>>>>>> https://github.com/apache/lucene/pull/120 >>>>>>> >>>>>>> Tomoko >>>>>>> >>>>>>> >>>>>>> 2021年5月1日(土) 8:15 Robert Muir <[email protected]>: >>>>>>> >>>>>>>> please submit a PR if you have the time! >>>>>>>> >>>>>>>> On Fri, Apr 30, 2021 at 3:38 PM Michael Wechner >>>>>>>> <[email protected]> wrote: >>>>>>>> > >>>>>>>> > sounds good to me :-) >>>>>>>> > >>>>>>>> > Would you like me to do a pull request or will you copy the >>>>>>>> README.md >>>>>>>> > yourself? >>>>>>>> > >>>>>>>> > Thanks >>>>>>>> > >>>>>>>> > Michael >>>>>>>> > >>>>>>>> > Am 30.04.21 um 16:59 schrieb Robert Muir: >>>>>>>> > > I'll throw out the idea of moving the README.md to >>>>>>>> > > https://github.com/apache/lucene/tree/main/lucene/luke >>>>>>>> > > >>>>>>>> > > That way it is in the main source tree, versioned, and pushed >>>>>>>> as part >>>>>>>> > > of the release process. We could then fix the gradle >>>>>>>> documentation >>>>>>>> > > task to incorporate any module's README.md into the main release >>>>>>>> > > documentation file (such as >>>>>>>> > > https://lucene.apache.org/core/8_8_2/index.html). Also for now >>>>>>>> at >>>>>>>> > > least, it would be visible from github too. >>>>>>>> > > >>>>>>>> > > On Fri, Apr 30, 2021 at 10:32 AM Jan Høydahl < >>>>>>>> [email protected]> wrote: >>>>>>>> > >> Hi >>>>>>>> > >> >>>>>>>> > >> That could be feasible. Have a look at the website git repo at >>>>>>>> https://github.com/apache/lucene-site. >>>>>>>> > >> Should be fairly easy to move the Markdown files from github >>>>>>>> to this site, which also accepts Markdown... >>>>>>>> > >> >>>>>>>> > >> Jan >>>>>>>> > >> >>>>>>>> > >>> 30. apr. 2021 kl. 08:41 skrev Michael Wechner < >>>>>>>> [email protected]>: >>>>>>>> > >>> >>>>>>>> > >>> Hi >>>>>>>> > >>> >>>>>>>> > >>> I just noticed that Luke became a Lucene Module >>>>>>>> > >>> >>>>>>>> > >>> https://github.com/DmitryKey/luke#important-notice >>>>>>>> > >>> >>>>>>>> https://mocobeta.medium.com/luke-become-an-apache-lucene-module-as-of-lucene-8-1-7d139c998b2 >>>>>>>> > >>> https://lucene.apache.org/core/8_8_2/luke/index.html >>>>>>>> > >>> >>>>>>>> > >>> Wouldn't it make sense to move the "Usage documentation of >>>>>>>> Luke" from https://github.com/DmitryKey/luke#luke to somewhere >>>>>>>> inside lucene.apache.org? >>>>>>>> > >>> >>>>>>>> > >>> Thanks >>>>>>>> > >>> >>>>>>>> > >>> Michael >>>>>>>> > >>> >>>>>>>> > >>> >>>>>>>> > >>> >>>>>>>> --------------------------------------------------------------------- >>>>>>>> > >>> To unsubscribe, e-mail: [email protected] >>>>>>>> > >>> For additional commands, e-mail: [email protected] >>>>>>>> > >>> >>>>>>>> > >> >>>>>>>> > >> >>>>>>>> --------------------------------------------------------------------- >>>>>>>> > >> To unsubscribe, e-mail: [email protected] >>>>>>>> > >> For additional commands, e-mail: [email protected] >>>>>>>> > >> >>>>>>>> > > >>>>>>>> --------------------------------------------------------------------- >>>>>>>> > > To unsubscribe, e-mail: [email protected] >>>>>>>> > > For additional commands, e-mail: [email protected] >>>>>>>> > > >>>>>>>> > >>>>>>>> >>>>>>>> >>>>>>>> --------------------------------------------------------------------- >>>>>>>> To unsubscribe, e-mail: [email protected] >>>>>>>> For additional commands, e-mail: [email protected] >>>>>>>> >>>>>>>> >>>>>>> >>>>>> >>>> -- >>>> Uwe Schindler >>>> Achterdiek 19, 28357 Bremen >>>> https://www.thetaphi.de >>>> >>> >>> > > -- > -- > Dmitry Kan > Luke Toolbox: http://github.com/DmitryKey/luke > Blog: https://dmitry-kan.medium.com/ > Twitter: http://twitter.com/dmitrykan > > >
