[sakai-pmc] Review 10.4 documentation?

[Steve Swinsburg]

   - The tagline 'Created by and for a global education community' is
   formatted weird and seems out of place.
   - Heading 'Whats new in 10.2' is different style to the others. Likewise
   with 10.0.
   - List of items in 10.4 is all bold and grey, different in 10.1 and 10.0
   where its bolded then has a normal weight description.
   - 10.0 and 10.1 has a bulleted list of items, 10.2 onwards does not and
   the spacing is different.
   - Maybe add a prominent link to the page from here?
   https://www.sakaiproject.org/sakai-10

Sorry, all seems negative, but some styling has gone amiss somewhere which
is breaking that page. Once that's sorted, its just content.

I do agree that a specific number of fixes is better though. If its out by
an issue or two because of a badly tagged jira then it doesnt matter, no
one is going to sue us, but the words do matter in terms of presenting the
data.

cheers,
Steve

On Thu, Feb 19, 2015 at 7:52 AM, Neal Caidin <neal.caidin at apereo.org> wrote:

> 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).
>>
>
>
> _______________________________________________
> sakai-pmc mailing list
> sakai-pmc at collab.sakaiproject.org
> http://collab.sakaiproject.org/mailman/listinfo/sakai-pmc
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://collab.sakaiproject.org/pipermail/sakai-pmc/attachments/20150219/d06cf404/attachment-0001.html