lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Hoss Man (Created) (JIRA)" <j...@apache.org>
Subject [jira] [Created] (SOLR-3183) remove legacy forrest site from solr release
Date Wed, 29 Feb 2012 19:57:57 GMT
remove legacy forrest site from solr release
--------------------------------------------

                 Key: SOLR-3183
                 URL: https://issues.apache.org/jira/browse/SOLR-3183
             Project: Solr
          Issue Type: Improvement
            Reporter: Hoss Man
            Priority: Blocker
             Fix For: 3.6, 4.0


A broader discussion is taking place on the dev list about how we want to more forward with
dealing with core/solr documentation in a post-forrest world, but a more immediate concern
is while the forrest based docs on the lucene side of things are already version specific
and could be released _now_, the solr forrest docs are not -- if we attempted to release 3.6
today the solr "docs" dir would contain a complete copy of the _old_ forrest generated website
that would make no sense to users.

we could just flat out remove the solr forrest docs, but that doesn't really address the issue
of the tutorial.  A copy of the tutorial currently exists on the CMS powered website, but
since it's not versioned it won't really help with the 3.6 vs 4x situation that will arise
in the very near future.

My suggestion for the short term is that we do the following on both branches:
* svn mv solr/site/tutorial.html solr/core/src/java/doc-files and then clean it up to remove
all the forrest navigation
* update solr/core/src/java/overview.html to mention and link to the tutorial
* eliminate solr/site and solr/site-src from trunk and branch-3x and adjust the build.xml
as needed

...that would get us into the state where we could release 3.6 at will w/o a weird documentation
cluster fuck, and the contents of https://lucene.apache.org/solr/tutorial.html could be updated
to become a meta-info page about the tutorial with a link to http://lucene.apache.org/solr/api/tutorial.html
(where we'd have already updated the javadocs to represent 3.6).



--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

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


Mime
View raw message