[Using Sakai] Sakai Documentation Redesign Call

Fri Dec 10 15:05:59 PST 2010

Post-call thoughts, posted before the weekend flushes them away forever:

At the end of the call we seemed to land on a goal of improving the
existing OOTB documentation (the source of which is the IU KB) for the
2.8 release. I think some ideas for next steps might include:

 - identifying a project lead (strongly suggested by Seth) that would
be the point of contact from this group to the TCC
 - identifying the sections of the existing OOTB docs we want to target for 2.8
 - assigning teams to create content for the project
 - identifying existing resources that a writing team could use to
improve those sections
 - writing teams revising the documentation, incorporating community
resources where available
 - teams reporting progress to the project lead
 - project lead reporting to the TCC (and the IU KB staff for inclusion?)

I suggest writing teams because I think that technical writing isn't a
great solo activity and that 2 working together could do more than 2
alone on separate sections. It also serves as a "self-QA".

Sean

On Fri, Dec 10, 2010 at 2:21 PM, Robin Hill <Hill at uwyo.edu> wrote:
> I have added these Oxford resources to our long-standing collection of
> End-User Support Resources, in the category "Tutorials -- Video and
> Written."  They are quite good, and comprehensive; I recommend a long look.
> Oxford also provides a Sakai Administrators' FAQ (also listed here and on
> that page).
>
> The issue how to repurpose and adapt other institutions' documentation to
> our own campuses remains, of course, and is subject to discussion today.
>
>
> --
>   Robin K. Hill, Ph. D.      Coordinator of Instructional Computing,
> University of Wyoming
>   http://www/uwyo.edu/ctl
>   [On professional leave, 2010-2011]
>   hill at uwyo.edu        307-760-8508   http://www.uwyo.edu/HILL
>
> ________________________________
> From: Adam Marshall [adam.marshall at oucs.ox.ac.uk]
> Sent: Friday, December 03, 2010 3:56 AM
> To: Mathieu Plourde; Sean Keesler; sakai-user at collab.sakaiproject.org;
> alan.regan at pepperdine.edu; lorie at uwindsor.ca; Robin Hill;
> Matt.Clare at brocku.ca; mwagner at umich.edu; psg3a at virginia.edu;
> kstiles at rsmart.com; rmorales at udgvirtual.udgd.mx; adam.marshall at ox.ac.uk;
> matt.schneider at jhu.edu; ws15 at txstate.edu; adevans at vt.edu;
> jonmhays at media.berkeley.edu
> Subject: RE: [Using Sakai] Sakai Documentation Redesign Call
>
> I cant make the call but I would like to draw everybody’s attention to our
> documentation which is licensed with Creative Commons.
>
>
>
> We also have videos.
>
>
>
> We would be very happy indeed for anybody else to make use of this material
> and would be keen to help in this area although we wouldn’t be able to
> commit too much time.
>
>
>
> ·         https://weblearn.ox.ac.uk/portal/hierarchy/info
>
> ·
> https://weblearn.ox.ac.uk/access/content/group/info/hidden/visible/html/SBSGlist.html
>
> ·         http://www.oucs.ox.ac.uk/ltg/teachingwithtechnology/guides.xml
>
> ·
> https://weblearn.ox.ac.uk/access/content/group/info/hidden/visible/html/Videolist.html
>
> ·         Better wiki help:
> https://weblearn.ox.ac.uk/access/wiki/site/info/local-wiki-help.html?breadcrumb=0
>
> ·         originals: http://www.oucs.ox.ac.uk/weblearn/documentation/
>
> ·
> https://weblearn.ox.ac.uk/access/content/group/info/other/adminfaq.html
>
>
>
> adam
>
>
>
> From: sakai-user-bounces at collab.sakaiproject.org
> [mailto:sakai-user-bounces at collab.sakaiproject.org] On Behalf Of Mathieu
> Plourde
> Sent: 02 December 2010 20:32
> To: Sean Keesler; sakai-user at collab.sakaiproject.org;
> alan.regan at pepperdine.edu; lorie at uwindsor.ca; hill at uwyo.edu;
> Matt.Clare at brocku.ca; mwagner at umich.edu; psg3a at virginia.edu;
> kstiles at rsmart.com; rmorales at udgvirtual.udgd.mx; adam.marshall at ox.ac.uk;
> matt.schneider at jhu.edu; ws15 at txstate.edu; adevans at vt.edu;
> jonmhays at media.berkeley.edu
> Subject: Re: [Using Sakai] Sakai Documentation Redesign Call
>
>
>
> BTW, the agenda is located at
>
> http://confluence.sakaiproject.org/display/ESUP/End-User+Documentation+Meetings
>
> Feel free to modify, comment, etc.
>
> Mathieu
> =================================
>
> Mathieu Plourde, MBA
> Project Leader, LMS/Instructional Designer
> IT-Client Support & Services
> mathieu at udel.edu
> Office: 302-831-4060
>
> =================================
>
> TOP LINKS:
>
> Technology Troubleshooting: http://www.udel.edu/help
> Sakai at UD Support and Training: http://www.udel.edu/sakai/training
>
> =================================
>
> On Thu, Dec 2, 2010 at 3:09 PM, Sean Keesler <sean.keesler at threecanoes.com>
> wrote:
>
> It appears that 10 out of the 11 respondents to the poll are available
> on 3pm EST on next Friday.
> No one new has responded today.
> I've tentatively scheduled the Sakai 003 bridge for 3pm EST (8pm GMT).
>
> Telephone: +1 812 856 7060
> Conference Code: 22386#
> PIN: 72524#
>
> Does anyone have any comments on the agenda?
>
> Sean Keesler
> 130 Academy Street
> Manlius, NY 13104
> 315-682-0830
> sean.keesler at threecanoes.com
>
> On Tue, Nov 30, 2010 at 4:57 PM, sean.keesler
> <sean.keesler at threecanoes.com> wrote:
>
>> Mathieu has asked me to get a conference call up and running for those
>> that
>> expressed interest in participating in an effort to improve the Sakai
>> documentation. We had a list of interested parties (cc'd here), but I am
>> also sending this to the entire Sakai-User list in case you missed it.
>> The suggestion was made that we could start with a call (I like 1 hour
>> calls) on Wednesday or Friday afternoon (Eastern time) next week.
>> You can get help us schedule by responding to this availability poll:
>> http://doodle.com/8nemdfpn7vsze26t
>> A proposed agenda for a 1 hour meeting would include:
>> - Introductions/Expectations/Skills/Availability of participants
>> - Define goals - scope (ie: redistributable KB or wiki, prioritized list
>> of
>> docs needed)
>> - Timeframe for project
>> - Success stories, other products available?
>> - Define structure of the group if we get that far...
>>
>> The confluence page that we are using to organize this is here:
>> http://confluence.sakaiproject.org//x/iII9B
>> The thread that precipitated it is here:
>>
>> http://collab.sakaiproject.org/pipermail/sakai-user/2010-October/thread.html#1488
>>
>>
>> Sean Keesler
>> 130 Academy Street
>> Manlius, NY 13104
>> 315-682-0830
>> sean.keesler at threecanoes.com
>>
>
>