[jbosstools-issues] [JBoss JIRA] (TOOLSDOC-313) Copyrights and versions stated in documents do not align with the release version of the doc & the JBT release version

Nick Boldt (JIRA) jira-events at lists.jboss.org
Wed Nov 20 15:33:05 EST 2013


    [ https://issues.jboss.org/browse/TOOLSDOC-313?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12925497#comment-12925497 ] 

Nick Boldt edited comment on TOOLSDOC-313 at 11/20/13 3:32 PM:
---------------------------------------------------------------

I see that the changes described in the latest PR (#71) have been done in master branch, but not in 4.1.x branch. 

As [~mmurray] says, the copyright dates are still hardcoded in the master.xml files, but at least the VERSION is now pulled from the pom.xml value instead of being hardcoded.

Therefore:

* https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/DevStudio/view/DevStudio_Trunk/job/jbosstools-docs-nightly/
** https://github.com/jbosstools/jbosstools-hibernate/blob/master/docs/reference/en-US/master.xml#L54
*** http://docs.jboss.org/tools/nightly/trunk/en/hibernatetools/html/index.html

{code} Version: 4.2.0.Final-SNAPSHOT
Copyright © 2007, 2008, 2009, 2010, 2011{code}

But:

* https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/DevStudio/view/DevStudio_7.0.kepler/job/jbosstools-docs_41/
** https://github.com/jbosstools/jbosstools-hibernate/blob/jbosstools-4.1.x/docs/reference/en-US/master.xml#L54
*** http://docs.jboss.org/tools/4.1.1.x/en/hibernatetools/html/index.html

{code} Version: 3.3.0.M5
Copyright © 2007, 2008, 2009, 2010, 2011{code}

Seems to me that we need to bump the copyright dates on all these docs to 2013, and backport the changes in master to the 4.1.1.x and 4.1.x branches so that these "3.3.0.M5" versions can finally be replaced by 4.1.1.

If we don't feel there's enough time to do that in both the 4.1.1.x and 4.1.x branches, or it's not worth it, then I propose instead:

a) *bump copyrights to 2014* in 4.1.x branch (due March 2014) and master (due July 2014)

b) *set versions to 4.1.2* in 4.1.x branch (due March 2014)

                
      was (Author: nickboldt):
    I see that the changes described in the latest PR (#71) have been done in master branch, but not in 4.1.x branch. 

As [~mmurray] says, the copyright dates are still hardcoded in the master.xml files, but at least the VERSION is now pulled from the pom.xml value instead of being hardcoded.

Therefore:

* https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/DevStudio/view/DevStudio_Trunk/job/jbosstools-docs-nightly/
** https://github.com/jbosstools/jbosstools-hibernate/blob/master/docs/reference/en-US/master.xml#L54
*** http://docs.jboss.org/tools/nightly/trunk/en/hibernatetools/html/index.html

{code} Version: 4.2.0.Final-SNAPSHOT
Copyright © 2007, 2008, 2009, 2010, 2011{code}

But:

* https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/DevStudio/view/DevStudio_7.0.kepler/job/jbosstools-docs_41/
** https://github.com/jbosstools/jbosstools-hibernate/blob/jbosstools-4.1.x/docs/reference/en-US/master.xml#L54
*** http://docs.jboss.org/tools/4.1.1.x/en/hibernatetools/html/index.html

{code} Version: 3.3.0.M5
Copyright © 2007, 2008, 2009, 2010, 2011{code}

                  
> Copyrights and versions stated in documents do not align with the release version of the doc & the JBT release version
> ----------------------------------------------------------------------------------------------------------------------
>
>                 Key: TOOLSDOC-313
>                 URL: https://issues.jboss.org/browse/TOOLSDOC-313
>             Project: Documentation for JBoss Tools and Developer Studio
>          Issue Type: Bug
>      Security Level: Public(Everyone can see) 
>          Components: General documentation issues
>    Affects Versions: 4.0.1, 4.1.0
>            Reporter: Nick Boldt
>            Assignee: Michelle Murray
>             Fix For: 4.2.0
>
>
> Some places where docs' copyright dates and stated versions do not align with the version of the doc:
> {code:title=http://docs.jboss.org/tools/4.0.1.Final/en/GettingStartedGuide/html/index.html}
> Version: 4.0.0
> Copyright © 2012 JBoss by Red Hat
> {code}
> {code:title=http://docs.jboss.org/tools/4.0.1.Final/en/beginners_guide/html/index.html}
> Version: 3.3.0.M5
> Copyright © 2011 JBoss by Red Hat
> {code}
> {code:title=http://docs.jboss.org/tools/4.0.1.Final/en/as/html/index.html}
> Version: 3.3.0.M5
> Copyright © 2007, 2008, 2009, 2010 JBoss by Red Hat
> {code}
> {code:title=http://docs.jboss.org/tools/4.0.1.Final/en/jmx_ref_guide/html/index.html}
> Copyright © 2007, 2008, 2009, 2010, 2011 JBoss by Red Hat
> {code}
> And yes, this is still a problem in trunk:
> {code:title=http://docs.jboss.org/tools/nightly/trunk/en/beginners_guide/html/index.html}
> Version: 3.3.0.M5
> Copyright © 2011 JBoss by Red Hat
> {code}
> {code:title=http://docs.jboss.org/tools/nightly/trunk/en/forge_reference/html/index.html}
> Version: 3.3.1
> Copyright © 2012 JBoss by Red Hat
> {code}

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira



More information about the jbosstools-issues mailing list