[jira] [Commented] (LANG-939) Move Documentation from user guide to package-info files

2014-01-17 Thread Benedikt Ritter (JIRA)

[ 
https://issues.apache.org/jira/browse/LANG-939?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=13874719#comment-13874719
 ] 

Benedikt Ritter commented on LANG-939:
--

Making changes is an issue, yes. But if we really try to push out release more 
frequently, this is not too bad.

I don't understand what you mean with only new users get the improvements. We 
publish the API doc on the website. That's where users currently find the user 
guide. It will be still available there, so even if you use an older version of 
[lang], you can still look ab the current package JavaDoc.

 Move Documentation from user guide to package-info files
 

 Key: LANG-939
 URL: https://issues.apache.org/jira/browse/LANG-939
 Project: Commons Lang
  Issue Type: Task
  Components: General
Affects Versions: 3.2
Reporter: Benedikt Ritter
 Fix For: 3.3, Patch Needed


 As discussed on the ML [1], the user guide on the website currently contains 
 documentation that would better suite in the corresponding package-info 
 files. The Documentation should be split up and moved to those files.
 [1] http://markmail.org/message/jgyacp3pv3t43s4h



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)


[jira] [Commented] (LANG-939) Move Documentation from user guide to package-info files

2014-01-17 Thread Benedikt Ritter (JIRA)

[ 
https://issues.apache.org/jira/browse/LANG-939?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=13874795#comment-13874795
 ] 

Benedikt Ritter commented on LANG-939:
--

I'm working on this now.

 Move Documentation from user guide to package-info files
 

 Key: LANG-939
 URL: https://issues.apache.org/jira/browse/LANG-939
 Project: Commons Lang
  Issue Type: Task
  Components: General
Affects Versions: 3.2
Reporter: Benedikt Ritter
Assignee: Benedikt Ritter
 Fix For: 3.3


 As discussed on the ML [1], the user guide on the website currently contains 
 documentation that would better suite in the corresponding package-info 
 files. The Documentation should be split up and moved to those files.
 [1] http://markmail.org/message/jgyacp3pv3t43s4h



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)


[jira] [Commented] (LANG-939) Move Documentation from user guide to package-info files

2014-01-04 Thread Henri Yandell (JIRA)

[ 
https://issues.apache.org/jira/browse/LANG-939?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=13862410#comment-13862410
 ] 

Henri Yandell commented on LANG-939:


Down side of this btw is that it ties our documentation to the release. Making 
a change means a release roll out and only new users get the improvements. 

 Move Documentation from user guide to package-info files
 

 Key: LANG-939
 URL: https://issues.apache.org/jira/browse/LANG-939
 Project: Commons Lang
  Issue Type: Task
  Components: General
Affects Versions: 3.2
Reporter: Benedikt Ritter
 Fix For: 3.3, Patch Needed


 As discussed on the ML [1], the user guide on the website currently contains 
 documentation that would better suite in the corresponding package-info 
 files. The Documentation should be split up and moved to those files.
 [1] http://markmail.org/message/jgyacp3pv3t43s4h



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)


[jira] [Commented] (LANG-939) Move Documentation from user guide to package-info files

2014-01-03 Thread Benedikt Ritter (JIRA)

[ 
https://issues.apache.org/jira/browse/LANG-939?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=13861366#comment-13861366
 ] 

Benedikt Ritter commented on LANG-939:
--

Makes sense to me. Fix version set to 3.3.

 Move Documentation from user guide to package-info files
 

 Key: LANG-939
 URL: https://issues.apache.org/jira/browse/LANG-939
 Project: Commons Lang
  Issue Type: Task
  Components: General
Affects Versions: 3.2
Reporter: Benedikt Ritter
 Fix For: 3.3, Patch Needed


 As discussed on the ML [1], the user guide on the website currently contains 
 documentation that would better suite in the corresponding package-info 
 files. The Documentation should be split up and moved to those files.
 [1] http://markmail.org/message/jgyacp3pv3t43s4h



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)


[jira] [Commented] (LANG-939) Move Documentation from user guide to package-info files

2014-01-02 Thread Henri Yandell (JIRA)

[ 
https://issues.apache.org/jira/browse/LANG-939?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanelfocusedCommentId=13861254#comment-13861254
 ] 

Henri Yandell commented on LANG-939:


This should be in 3.3 rather than 3.2.1 (assuming the plan is to get a 3.2.1 
out as soon as possible). This item doesn't seem as pressing as the others.

 Move Documentation from user guide to package-info files
 

 Key: LANG-939
 URL: https://issues.apache.org/jira/browse/LANG-939
 Project: Commons Lang
  Issue Type: Task
  Components: General
Affects Versions: 3.2
Reporter: Benedikt Ritter
 Fix For: 3.2.1, Patch Needed


 As discussed on the ML [1], the user guide on the website currently contains 
 documentation that would better suite in the corresponding package-info 
 files. The Documentation should be split up and moved to those files.
 [1] http://markmail.org/message/jgyacp3pv3t43s4h



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)