You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Hoss Man (Resolved) (JIRA)" <ji...@apache.org> on 2012/03/07 01:39:57 UTC

[jira] [Resolved] (SOLR-3183) remove legacy forrest site from solr release

     [ https://issues.apache.org/jira/browse/SOLR-3183?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Hoss Man resolved SOLR-3183.
----------------------------

    Resolution: Fixed

Committed revision 1297806.
Committed revision 1297809.

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