Bug 1123331
Summary: | JBoss Marshalling problems in release notes: duplication, known issue documented as bugfix, bad text for a bugfix | ||
---|---|---|---|
Product: | [JBoss] JBoss Enterprise Application Platform 6 | Reporter: | Ladislav Thon <lthon> |
Component: | Documentation | Assignee: | Scott Mumford <smumford> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Ladislav Thon <lthon> |
Severity: | high | Docs Contact: | |
Priority: | unspecified | ||
Version: | 6.3.0 | CC: | bmaxwell, lcosti, sgilda |
Target Milestone: | GA | ||
Target Release: | EAP 6.3.0 | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Bug Fix | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2014-08-06 14:40:14 UTC | Type: | Bug |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Ladislav Thon
2014-07-25 10:45:00 UTC
I did the following: - Set the 'requires_doc_text' flag to '-' in Bug 1122327 because it is targeted for 6.4 and duplicates Bug 1102271. - Set the 'requires_doc_text' flag to '-' in Bug 1122328 because it is targeted for 6.4 and duplicates Bug 1104328. - Changed the Doc Type from 'Bug Fix' to 'Known Issue' in Bug 1104328 since it will not make the 6.3.0 release. - Updated the release notes Doc Text field in Bug 1104328 to indicate it's a known issue and not a bug fix. The only outstanding issue is the last one: And last but not least, 1122327/1102271 (that is, upstream issue JBMAR-161) was indeed fixed in 6.3.0, but the release notes text describes a different issue (in fact, it describes a second part of JBMAR-162). Correct text should be provided. Added proposed Release Notes text to the comment in Bug 1102271. Modified the Release Notes text for Bug 1102271 based on discussions with Brad. Changes in comments 1 and 3 are now ready for review (Revision 6.3.0-18): https://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/index.html I'm moving this back to ASSIGNED to at least discuss this: Bug 1104328 (first part of JBMAR-162) is now correctly documented as a Known Issue, but there is another known issue (second part of JBMAR-162) that isn't documented at all (release notes item for that second issue was previously provided as a Doc Text for bug 1102271, which was of course incorrect). Do we want to document this too? It's probably fine if we decide we don't, because the entire JBMAR-161+JBMAR-162 problem only affects one customer (AFAIK), but it's worth thinking a bit. -- Also, if we are back to ASSIGNED, one minor nitpick. The description of known issue 1104328 says: "A ClassNotFoundException may be encountered during marshalling if a class is missing from the hierarchy of a serialized class." If I'm not mistaken, the exception can happen during _unmarshalling_, not marshalling. Fixed the text in Bug 1104328, A new build of the 6.3.0 Release Notes (version 6.3.0-19) is available for review at: https://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/6.3.0_Release_Notes/ Brew task: http://brewweb.devel.redhat.com/brew/taskinfo?taskID=7777030 OK, so the decision seems to be to keep the second part of JBMAR-162 undocumented. Fine with me. Reviewed in Revision 6.3.0-19. |