Hi, Main question: Should we [] Lock down the Solr Wiki sooner rather than later and put all focus on adding to and improving the Ref Guide [] Leave the wiki open for anyone to edit now and selectively go through and try to reconcile it (and delete as we move) and encourage people to go to the ref guide. (in other words, continue as is)
Background: I'm in a position to deploy some resources to work on Solr's documentation a bit more. Namely, I'd like to close the gaps/differences/discrepancies between the wiki and the ref guide. I know Hoss, Cassandra and others have come up with a plan for addressing these gaps by going through the pages, highlighting the diffs and reconciling them in the ref guide and then removing from the wiki, with the goal being that the Ref Guide is the one and only authoritative documentation and the wiki is solely for uncurated user tips, tricks and ideas. Before doing that, however, I think it is worth asking the question: What if we just "ripped off the band-aid" instead and simply archived the wiki (move all the current content to an archive area on the wiki and mark that area as read only) and change the landing page to refer all documentation questions to the Ref Guide and the Wiki should simply be tips, tricks, etc. and is NOT official documentation and committers, for the most part, don't worry about curating content there. We'd need to put in the appropriate redirects (or at least some redirects) as well, but otherwise, not worry about reconciling things but instead focus on going through the Ref Guide and simply adding to it "fresh" without worry about what is on the wiki. My gut says Google will recrawl/update to the Ref Guide as the authoritative version pretty quickly and the rest of the world will follow suit soon thereafter. Naturally, we'd lose some of the links from places like StackOverflow, etc. but if we redirect appropriately, we could minimize the pain of this. Naturally, I can still focus resources on just doing the ref guide and leave others to do the cross referencing, but I think it is important that we try to come to some level of agreement on what to do w/ the old content, hence the email to gather other people's opinions. -Grant -------------------------------------------- Grant Ingersoll | @gsingers http://www.lucidworks.com
