On 4/6/2014 4:12 AM, Grant Ingersoll wrote:
> While I somewhat agree with both the points of Furkan and Alexandre, I
> am not sure which way you are leaning:  Should we pull off the band-aid
> or not?  And do no other committers have an opinion here?

One of the strengths (and weaknesses!) of the old wiki is that anyone
who asks for permission is allowed to edit it. If I filter my email
archive for 'wikidiffs' so I can see old wiki change notifications, most
of the changes in the last year have come from committers.  It would be
incorrect to state that non-committer contributions are completely
trivial, though.  A few of them have been very active.

Only committers can change the reference guide ... which is reasonable
because it's published as official documentation.

I am inclined to vote that we take these steps:

1) Lock down the old wiki, at least temporarily.
2) Improve the SEO of the reference guide.
3) Beef up the reference guide with *relevant* info from the wiki.

Further steps will require some thought.

For wiki pages which directly correspond to reference guide pages, it's
reasonable and appropriate to phase them out after making sure that
everything important gets transferred to the reference guide.

There is other content in the wiki, though.  One of my larger
contributions to the old wiki is the page about performance problems.
While I do think this an appropriate topic to put in the reference
guide, there might be things stated there that the project does not want
to declare in an official voice.  I like to think that those things are
important, so I'd hate to see them disappear entirely.

http://wiki.apache.org/solr/SolrPerformanceProblems

Perhaps we can re-purpose the old wiki into a supplement to the
reference guide, once again open to modification by contributors.
Tips/tricks and information that's not suitable for official
documentation can live there.  This MIGHT make it a natural staging
ground for improvements and large-scale changes to the reference guide,
both from the community and committers.

Thanks,
Shawn


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

Reply via email to