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

Hoss Man updated SOLR-238:
--------------------------

    Attachment: SOLR-238.diff

Thorsten (et al) I'd apprecaite your feedback on this patch revision...

1) moved the location of the variables file to ./build using a deep ../../ path 
 ... i didn't change the forrest.properties to do this, because I wanted to 
keep the catalog.xcat where it was since that seems to be standard.

2) from a clean check out "ant init-forrest-entities" is now a prepreq for 
forrest to run properly, otherwise the XML doesn't validate because the 
entities can't resolve.  most of hte core ant tasks take care of this via 
dependencies.

a couple of notes about the specifics...

a) i used the "specversion" since it's the most precise of our version numbers, 
it contains the datetime of dev builds, and is the number you would expect for 
official builds
b) i tried to make the entity name consistent with the property name so that if 
someone smarter then me knows a way to get ant to dump all properties using a 
<filterchain> we can refer to any ant properties as entities not just 
solr.specversion
c) if committed, Website_Update_HOWTO needs note about "ant 
init-forrest-entities"
d) if committed, HowToRelease needs updated to indicate that the docs on the 
branch need regenerated/commited after building/testing the code *sith 
specversion set*, but before packaging.


> [Patch] The tutorial on our website is against trunk which causes confusion 
> by user
> -----------------------------------------------------------------------------------
>
>                 Key: SOLR-238
>                 URL: https://issues.apache.org/jira/browse/SOLR-238
>             Project: Solr
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Thorsten Scherler
>         Assigned To: Hoss Man
>         Attachments: SOLR-238.diff, SOLR-238.diff, SOLR-238.diff, 
> SOLR-238.diff, SOLR-238.png
>
>
> The patch will add a note to the tutorial page with the following headsup:
> "This is documentation for the development version (TRUNK). Some instructions 
> may only work if you are working against svn head."

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to