lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Grant Ingersoll <grant.ingers...@gmail.com>
Subject Re: [jira] Commented: (LUCENE-805) New Lucene Demo
Date Mon, 19 Feb 2007 12:36:08 GMT
To add to this, we could keep the same pointers for now, and just  
have them point into the Wiki so that people aren't completely lost  
by the changes.

On Feb 18, 2007, at 7:46 AM, Grant Ingersoll wrote:

> I'm all for the Wiki, just not sure how to get people to move to it.
>
> One idea is to move all of our main documentation there.  That is,  
> move almost all of the content under "Documentation" to the wiki  
> and then update the wiki into a more coherent landing page.
>
> I would suggest we keep the following under the documentation link:
> API Docs
> File Formats
>
> -Grant
>
>
> On Feb 15, 2007, at 7:20 PM, Erik Hatcher wrote:
>
>>
>> On Feb 15, 2007, at 2:33 PM, Grant Ingersoll wrote:
>>> I think that code is great and is often self-documenting, but it  
>>> only represents the result of someone writing the code, it  
>>> doesn't explain the why part of it.  So, it would need English  
>>> (and translations???) to explain why a particular approach was  
>>> taken, along with possible alternatives.
>>
>> So how about following the Solr lead with incredible wiki  
>> documentation and tutorial stuff.  The code could be contributed  
>> and then documented by the community.
>>
>> I'd have no problem copy/pasting sections of LIA that were  
>> relevant and useful.  Or writing some stuff from scratch on the  
>> examples.
>>
>> 	Erik
>>
>>
>>>
>>>
>>> On Feb 15, 2007, at 2:25 PM, Erik Hatcher (JIRA) wrote:
>>>
>>>>
>>>>     [ https://issues.apache.org/jira/browse/LUCENE-805? 
>>>> page=com.atlassian.jira.plugin.system.issuetabpanels:comment- 
>>>> tabpanel#action_12473480 ]
>>>>
>>>> Erik Hatcher commented on LUCENE-805:
>>>> -------------------------------------
>>>>
>>>> That was my concern as well, Grant.  At least the LIA code is  
>>>> fairly well self documenting (we used JUnit for a reason :) and  
>>>> the build file itself is a nice example of how to launch  
>>>> applications and examples from a common starting point.
>>>>
>>>> What other documentation would be needed to make this a palatable?
>>>>
>>>>> New Lucene Demo
>>>>> ---------------
>>>>>
>>>>>                 Key: LUCENE-805
>>>>>                 URL: https://issues.apache.org/jira/browse/ 
>>>>> LUCENE-805
>>>>>             Project: Lucene - Java
>>>>>          Issue Type: Improvement
>>>>>          Components: Examples
>>>>>            Reporter: Grant Ingersoll
>>>>>         Assigned To: Grant Ingersoll
>>>>>            Priority: Minor
>>>>>
>>>>> The much maligned demo, while useful, could use a breath of  
>>>>> fresh air.  This issue is to start collecting requirements  
>>>>> about what people would like to see in a demo and what they  
>>>>> don't like in the current one.
>>>>> Ideas (not necessarily in order of importance):
>>>>> 1. More in-depth tutorial explaining indexing/searching
>>>>> 2. Multilingual support/demonstration
>>>>> 3. Better demonstration of querying capabilities: Spans,  
>>>>> Phrases, Wildcards, Filters, sorting, etc.
>>>>> 4. Dealing with different content types and pointers to resources
>>>>> 5. Wiki use cases links -- I think it would be cool to solicit  
>>>>> people to contribute use cases to the docs.
>>>>> 6. Demonstration of contrib packages, esp. Highlighter
>>>>> 7. Performance issues/factors/tradeoffs.  Lucene lessons  
>>>>> learned and best practices
>>>>> Advanced tutorials:
>>>>> 1. Hadoop + Lucene
>>>>> 2. Writing custom analyzers/filters/tokenizers
>>>>> 3. Changing Scoring
>>>>> 4. Payloads (when they are committed)
>>>>> Please contribute what else you would like to see.  I may be  
>>>>> able to address some of these issues for my ApacheCon talk, but  
>>>>> not all of them.
>>>>
>>>> -- 
>>>> This message is automatically generated by JIRA.
>>>> -
>>>> You can reply to this email to add a comment to the issue online.
>>>>
>>>>
>>>> ------------------------------------------------------------------- 
>>>> --
>>>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>>>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>>>
>>>
>>> ------------------------------------------------------
>>> Grant Ingersoll
>>> http://www.grantingersoll.com/
>>> http://www.paperoftheweek.com/
>>>
>>>
>>>
>>> -------------------------------------------------------------------- 
>>> -
>>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>
>
> ------------------------------------------------------
> Grant Ingersoll
> http://www.grantingersoll.com/
> http://lucene.grantingersoll.com
> http://www.paperoftheweek.com/
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>

------------------------------------------------------
Grant Ingersoll
http://www.grantingersoll.com/
http://lucene.grantingersoll.com
http://www.paperoftheweek.com/



---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Mime
View raw message