Writing a book with the help of the Sakai free software community

Writing a book with the help of the Sakai free software community


This article is about writing a book with the help of the free software community. The book in question is Sakai Courseware Management with the main authors being Alan Berg (Me myself and I) and Michael Korcuska, the executive director of the Sakai Foundation. In reality, around forty community members delivered valuable content, which the authors distributed strategically throughout the book.

Sakai

Sakai is a respected online platform for collaborative learning. Millions of students around the world, especially in higher education learn using this platform. Sakai is highly flexible and allows you to quickly make project and course sites. The power of the application is that, per site, you easily choose from a wide variety of tools such as chat, podcasting, forums, blogs, etc.

Sakai is used by Universities such as Michigan, MIT, Berkley, Amsterdam, Cape Town, Indiana. Over one-third of the top one hundred universities in the world participate in Sakai, providing a system now in use in over one hundred and sixty other universities, colleges and schools.

Figure 1: Sakai deploymentsFigure 1: Sakai deployments

If you are interested in trying out Sakai on your own computer, then I would recommend an article written by Alan Mark Berg, someone I know and have a great deal of respect for, he said modestly. The article is written for Sakai 2.4 but is also valid for the current version, 2.6. Version 2.6 has more tools and a slightly smoother user experience. It is a mature product, which can be scaled for up to a 160,000 user base.

The community has at its centre the Sakai Foundation, a non-profit organisation that manages the product roadmap, defends the product legally and coordinates conferences and supporting infrastructure such as the source code repository, bug tracking, Wiki, mailing lists and Quality Assurance. Organisations become members of the foundation and vote for a board. Investing in the Sakai Foundation is enlightened self-interest. If managed well it is cheaper and more reliable for a specific University to create an excellent student experience.

In this competitive time where commercial companies sue free software products in an apparent attempt to gain market dominance it is good to have a biodiversity of free software products. Arguably, without Sakai, Moodle or other free learning management systems, the choice of online learning systems would come down to one major commercial player. If that commercial player gets an econnomic cold or pushes the license costs up then you will experiece the cos and the pain too. Free software creates choice and bypasses vendor lock in.

I became involved in the Sakai project in my alter ego as senior developer, Quality Assurer and professional naysayer at the University of Amsterdam. The University saw the potential of the product and wanted to bring it into mainstream use as a student and researcher community builder. Sakai is also is used at Amsterdam for keeping track of students performance through online portfolios.

After numerous emails to public lists, creating some automatic quality assurance processes and generally being a pain I was awarded a Sakaiger (a stuffed toy). After being bitten by the stuffed toy I gained secret super powers, which I only use for good (or as a joke at parties). I gained a second stuffed toy, when I became a Sakai fellow. Becoming a Sakai fellow meant that I could ask the Central Computer Services at the University of Amsterdam, to give me the time I needed to help write an official Sakai Foundation sponsored book. We all agreed that any royalties made by the authors would go to the Foundation.

Figure 2: Sakaigers as photographed by Lawrence Berg (aged 9)Figure 2: Sakaigers as photographed by Lawrence Berg (aged 9)

I was highly motivated to write. I thought it better to lock myself in a darkened room for ten months rather than to talk to my colleagues. Probably because they were embarrassed to see me walking around the building with stuffed toys and wearing my underwear over my trousers, the University agreed. My family, especially my long-suffering wife, was supportive. However, if I had not asked for prior permission before writing the book, I suspect that my life insurance would have soared.

LESSON 1: To avoid heavy objects being dropped on your head, keep your family informed

The delivery of the book had well-defined deadlines. These deadlines made demands on the number of words that needed to be written in a day. Different authors work in different ways. I did not leave my desk until my word quota was reached. At a certain point, the potted plant and stuffed Sakaiger toy were the most viewed objects in my life. They counselled me through many long dark nights of the soul.

LESSON 2: Be prepared for a boring, regular workload if you want to hit your deadlines

I am neither the best nor the worst writer in the world. However, I do know the underlying technologies. I am by nature succinct, but sometimes under a high load can construct sentences that can contain colloquialisms. After producing 130,000 technically correct words, it was wise to filter out any offending sentences. Luckily, Margaret Wagner of Sakai newsletter fame unpicked my verbal tangles with patience and compassion.

LESSON 3: If you write fast, ask someone else to filter your masterpiece

Through my daily work, I knew many community members and did not feel awkward asking for their help. I decided to break the work into smaller parts, sending out email interviews and asking for support through the writing of case studies. The result was a lot of feedback and much valuable content including ten case studies. The quality of the content was OK and extremely good from a technical perspective. The responses required some light polishing, but not as much as I was originally expecting. It was really rather good. The main effort was directed at nudging specific authors to return their work on time.

LESSON 4: The more members of the community you interact with the harder it is to plan deadlines

LESSON 5: Break work up into doable packets such as interviews and case studies so that the community can focus and respond in a timely manner

LESSON 6: The main effort was not cleaning up content, but getting the content delivered on time

A significant number of chapters were written by Michael Korcuska and one by Josh Baron and another by David Jan Donner and Léon Raijmann. Working with co-authors made the reaching of deadlines more manageable and facilitated multiple perspectives. Michael focused on the proper way an educationalist should use Sakai and discussed its future. I was more focused on the technical structures. Josh described what made courses excellent, David Jan Donner and Raijmann looked at the key reasons to buy into Sakai. This interplay of different authors with different skill sets makes for a book that speaks clearly to different target audiences.

LESSON 7: Having more than one author makes for a well rounded book

Generally, writing is not a financially rewarding process due to the large number of hours you may need to invest. However, the process does teach you to trust your publisher and your co-authors. To form your own opinion about the quality of the book you can find two sample chapters on the PACKT website. If you are unsure of the potential value of Sakai in your organization then install the software on a test machine. The demo is simple to set up and fun to use.

Figure 3: The book's coverFigure 3: The book's cover

I have learnt other lessons during writing. However, you will have to corner me at a Sakai conference, force-feed me more whiskey than you can probably afford. The book was hard work, but in hindsight worth doing. Individual help from the Sakai community was numerous and supportive. Thank you all.

Acknowledgements

I would like to acknowledge the genetic similarities in humour with my father, especially the ones that land me in trouble. Thank you very, very much Dad.

Category: 

Author information

Alan Berg's picture

Biography

Alan Berg Bsc. MSc. PGCE, has been a lead developer at the Central Computer Services at the University of Amsterdam for the last eight years. In his spare time, he writes computer articles. He has a degree, two masters and a teaching qualification. In previous incarnations, he was a technical writer, an Internet/Linux course writer, and a science teacher. He likes to get his hands dirty with the building and gluing of systems. He remains agile by playing computer games with his kids who (sadly) consistently beat him physically, mentally and morally.

You may contact him at reply.to.berg At chello.nl

Most forwarded

Interview with Dave Mohyla, of DTIDATA

Dave Mohyla is the president and founder of dtidata.com, a hard drive recovery facility based in Tampa, Florida.

TM: Where are you based? What does your company do?
DTI Data recovery is based in South Pasadena, Florida which is a suburb of Tampa. We have been here for over 10 years. We operate a bio-metrically secured class 100 clean room where we perform hard drive recovery on all types of hard disks, from laptop hard drives to multi drive RAID systems.

Anybody up to writing good directory software?

Since the very beginning, directories (of any kind) have had a very central role in the internet. (I have recently grown fond of Free Web Directory. Even Slashdot can be considered a directory: a collection of great news and invaluable user-generated comments. As far as software is concerned, doing a quick search on Google about software directories will return the free (as in freedom) software directories like Savannah, SourceForge, Freshmeat and so on, followed by shareware and freeware sites such as FileBuzz, PCWin Download Center and All Freeware (great if you're looking for shareware and freeware, but definitely less comprehensive than their free-as-in-freedom counterparts).

Interview with Mark Shuttleworth

Mark Shuttleworth is the founder of Thawte, the first Certification Authority to sell public SSL certificates. After selling Thawte to Verisign, Mark moved on to training as an astronaut in Russia and visiting space. Once he got back he founded Ubuntu, the leading GNU/Linux distribution. He agreed on releasing a quick interview to Free Software Magazine.

Is better education the key to finding better software?

I read David Jonathon's article Anybody Up To Writing Good Directory Software? the other day, which got me thinking about software directories in general. As David mentioned, many of the software directories one finds when doing a quick google search are free as in beer, not as in freedom. But what interests me is the software directories that already exist, providing a combination of both free as in beer software, and open source software. Sites such as Freeware Downloads and Shareware Download don't advertise themselves as providing free as in liberty software, but each of them have a good selection of open source software available... if you know where to look.

Most emailed

Free Open Document label templates

If you’ve ever spent hours at work doing mailings, cursed your printer for printing outside the lines on your labels, or moaned “There has got to be a better way to do this,” here’s the solution you’ve been looking for. Working smarter, not harder! Worldlabel.com, a manufacture of labels offers Open Office / Libre Office labels templates for downloading in ODF format which will save you time, effort, and (if you want) make really cool-looking labels

Creating a user-centric site in Drupal

A little while ago, while talking in the #drupal mailing list, I showed my latest creation to one of the core developers there. His reaction was "Wow, I am always surprised what people use Drupal for". His surprise is somehow justified: I did create a site for a bunch of entertainers in Perth, a company set to use Drupal to take over the world with Entertainers.Biz.

Update: since writing this article, I have updated the system so that the whole booking process happens online. I will update the article accordingly!

So, why, why do people and companies develop free software?

More and more people are discovering free software. Many people only do so after weeks, or even months, of using it. I wonder, for example, how many Firefox users actually know how free Firefox really is—many of them realise that you can get it for free, but find it hard to believe that anybody can modify it and even redistribute it legally.

When the discovery is made, the first instinct is to ask: why do they do it? Programming is hard work. Even though most (if not all) programmers are driven by their higher-than-normal IQs and their amazing passion for solving problems, it’s still hard to understand why so many of them would donate so much of their time to creating something that they can’t really show off to anybody but their colleagues or geek friends.

Sure, anybody can buy laptops, and just program. No need to get a full-on lab or spend thousands of dollars in equipment. But... is that the full story?

Fun articles

Santa Claus - the most successful open source project

It dawned on me the other day, as I was shopping for the dozens of gifts it seems I have to buy every December, that Santa Claus is the most successful open source project in history. (Bridget @ Illiterarty would agree with that). Santa Claus is essentially a marketing development that is embodied by everyone who stuffs a sock, gives a gift, hosts a dinner or wishes Merry Christmas over the holiday season.

Most emailed

Editorial

When I first started thinking about Free Software Magazine, I was feeling enthusiastic about the dream. I had Dave, Gianluca, and Alan willing to help me, I had established members of the free software community willing to help me out, I had writers volunteering their time and energy for free, and I had a generous offer from OpenHosting for servers, all before I'd proved myself. There was a sense of excitement in the air, and I thought maybe, just maybe, I could make this work.

Free Software Magazine uses Apollo project management software and CRM for its everyday activities!