[sakai-pmc] Review 10.4 documentation?

[Neal Caidin]

I fixed things based on most of your suggestions.

I'm not sure, but I might have a slight difference of opinion on a couple
of your suggestions.

>"about 50 fixes"
The reason I often revert to this is because the exact count is hard to pin
down, in reality. Some things are not tagged that are in the release.
Occasionally (but more rarely) something that showing is merged really
hadn't been, and often, though not for this release, Security issues we
could be counted that most users don't see. To me, about 50 fixes is not
vague and is clearly distinguished from about 200 fixes for example. Those
numbers, imo, give the order of magnitude of the number of fixes. But, I
might be getting a little to uptight about the details there. I changed it
to a specific number.


> The link to the issues fixed should be in all communication.
I think of different communication channels as having different needs. I
agree the technical details should be on source.sakaiproject.org and on our
Confluence wiki release notes. I'm not as sure that they should be on
www.sakaiproject.org and on an email announcement to Apereo Announcements
or other non-technical lists. I'm thinking for those lists a high level
accounting of what you all accomplished is sufficient. But that is just my
opinion.

In summary, I'll try and remember to use the specific number instead of
"about 50" though it goes slightly against how I think of it, but no big
deal. It would be nice to come to a consensus on the communication channel
thing. And, I'm thinking I should probably slow down by 1/2 day and give
PMC/Core team a chance to review communications before I send them (which I
have been inconsistent about, I admit).

Thanks!




On Tue, Feb 17, 2015 at 3:23 PM, Sam Ottenhoff <ottenhoff at longsight.com>
wrote:

>
>>
>> Always nice if I can get a second pair of eyes to review the
>> documentation:
>>
>>
>>    - http://sakaiproject.org/current-release
>>
>>
> What's new in 10.4?  "Bug Fixes."  Please be specific with a number (not
> "about 50") and provide a link to those bug fixes.
>
> Tomcat is 7.0.56 not 7.056
>
> "compatibily" spelling
>
> Sakai 10.4 has a few highlights that are in your release notes.
> Simplified Chinese and Admin Documentation are not the core highlights.
>
> Please fix the headings.  They are inconsistent especially "What's new in
> Sakai 10.1"
>
>
>
>>    -
>>    and of course, the standard
>>    https://confluence.sakaiproject.org/display/DOC/Sakai+10+Release+Notes
>>
>>
>
>
> The recommendation for Tomcat 7.0.56+ up (because of WebDAV, I believe)
> and JDK 1.7.0_76 are pretty crucial and should be included in all
> communication about this release.
>
> The link to the issues fixed should be in all communication.  Your email
> to apereo-announce seemed vague ("about 50 fixes" with no list of fixes or
> link to fixes).
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://collab.sakaiproject.org/pipermail/sakai-pmc/attachments/20150218/36ca5b12/attachment.html