lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Steven Parkes" <steven_par...@esseff.org>
Subject RE: [jira] Commented: (LUCENE-664) [PATCH] small fixes to the new scoring.html doc
Date Fri, 25 Aug 2006 19:25:49 GMT
> I think things on the 
> Wiki get buried and ignored to some extent.

I've noticed there seems to be a real difference in style between the
(lucene) java subproject and the other java subprojects
nutch/hadoop/(solr). Particularly given the overlap in the dev
communities.

I wonder if the "second class" nature of the java wiki might be
addressed by "fixing it"? My initial reaction on seeing the FrontPage as
a single tabular list was a little more off putting, compared to the
style used by those other subprojects.

I think it was Doug that mentioned a while ago that a HowToContribute
page was needed. One exists for other projects' wikis but since the
style used by the other projects isn't the same, the content isn't quite
as easy to steal and place.

If there's any interest in this, I'd be up for doing some of it. I'm
climbing the learning curve anyway, so I'm up for putting in some effort
codify what I learned.

A related comment: it seems to me like the graph nature of the
abstractions/classes in Lucene makes them particularly difficult to
describe linearly. An example is the related nature of
analysis/tokenizing at index and query times. It strikes me that the
graph nature of a wiki is particularly helpful here. It helps flatten
the learning curve to be able to easily jump to a description of the
related components when reading, for example, about a particular
analyzer.

I came away feeling I wanted more in the wiki, not less.

---------------------------------------------------------------------
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