I was not proposing StackOverflow as some official docs.
Solr’s only official doc is the RefGuide, and the official user-contributed
docs is at http://wiki.apache.org/solr/ <http://wiki.apache.org/solr/>

But it may be that some of you Solr users want to contribute to StackOverflow’s
Solr topic, both in requesting topics, writing short snippets and fixing what is
wrong.

But I wonder if we should consider creating an official, slim Solr User Guide
as well, for end users, structured as a getting-started guide and with focus
on how you achieve a task, not documenting all 99 parameters a plugin can
take.

Regarding the links in the admin, the “Documentation” link should perhaps
link to http://lucene.apache.org/solr/resources.html#documentation 
<http://lucene.apache.org/solr/resources.html#documentation>
The other links seem ok though.

--
Jan Høydahl, search solution architect
Cominvent AS - www.cominvent.com

> 14. sep. 2016 kl. 23.11 skrev Gus Heck <gus.h...@gmail.com>:
> 
> While stack overflow is a great place, and the more good info that exists
> there, the merrier, I think Solr should have it's own complete docs, in
> addition to anything found on 3rd party sites. Each hop to a new location
> is a chance for the user to get lost, and the content on 3rd party sites
> could be wrong, out of date without folks here being aware of it as
> quickly.
> 
> Also, I just noticed that there seem to be some links at the bottom of the
> admin UI, but they often run off the bottom and can be easily missed. The
> "documentation" link doesn't actually lead to the documentation... Maybe
> those should be along the top where they would be easily seen and the
> link(s?) fixed up?
> 
> -Gus
> 
> On Wed, Sep 14, 2016 at 3:27 PM, Jan Høydahl <jan....@cominvent.com> wrote:
> 
>>> If you could decide, what kind of documentation would you want from the
>> project? A very short “Solr Quick start guide”? with step-by-step
>> instructions for the most common tasks from a User perspective?
>> 
>> I just became aware of StackOverflow’s Documentation project, which also
>> has a solr topic:
>> http://stackoverflow.com/documentation/solr <http://stackoverflow.com/
>> documentation/solr>
>> Perhaps that could also be a good place to contribute HOWTOs and more
>> end-user focused docs?
>> 
>> --
>> Jan Høydahl, search solution architect
>> Cominvent AS - www.cominvent.com
>> 
>> 
> 
> 
> -- 
> http://www.the111shift.com

Reply via email to