Solution Grove

Knowledge Management for Learning Communities

Login  

Collaborative Editing HOWTO


No registered users in community Articles and Tutorials
in last 10 minutes

Collaborative EditingHOWTO

The collaborative editing feature allows admins to add new documents and allow others to contribute edits. The admin can then take the contributions and create a new draft of the document. In addition to this documentation, there is a screencast of the end-user experience: Click Here for Screencast Demo

Use Case: A document author wishes to share a document and invite some people to edit the document on the collaborative wiki. The author enters the content into a new collaborative wiki page, and emails the editors a link to the page. Each editors changes are recorded seperately, and can be compared to the original document. After a round of editing the author will incorporate the changes and publish a new draft of the document. The editors can then make changes to this new draft and these changes can be compared to the new draft. There can be several rounds of editing.

Creating a new document 

To create a new document the admin will visit http://lnwprogram.org/collaborative-wiki/ and click on New Page. This brings up the edit screen.

Create_New_Collaborative_Page_2.jpg 

The admin types in a short name for the URL of the document in the Name field, and types in the title of the document in the Title field.

Next the admin clicks inside the text area for the content. From here the text can be entered directly, or copy and pasted into this field.

If text is copy and pasted from MS Word the admin should click on the icon that looks like the MS Word icon with the red circle with a slash through it word-clean-icon.jpg. This will clean up the HTML content from MS Word and make editing easier.

 After the content is done the admin clicks the OK button.

By default, documents are not viewable by the public until they are published. After ceating a new document the admin is sent to the Revisions page. Click on the button under Live Revision to publish the document.

Revisions_of_Entry_en-new-collaborative-document_1.jpg 

Calling for contributions 

After a new document is created, an admin can copy the URL of the new document and paste this into an email sent to a list of users who are invited to make contributions. This is done with a regular email client, outside the lnwprogram.org system. 

Editing a document

When a user wants to edit the document, they click on the Edit link if they are logged in, or Login to Edit link if they are not logged in. After the user logs in, if necessary, they are brough to the edit screen. From here the user can make any changes to the document using the standard editing tool.

 Viewing edits

When viewing a collaborative document, there will appear a tab for each users most recent contributions.

New_Collaborative_Document_Tabs.jpg 

To view the contributions of a user, click on the tab with their name. While viewing the user's contributions all text removed will be shown as strikethrough text in red. All added text will be shown with a reversed background in green. From here you can click on another user's tab or Live Version to see the latest published version of the document.


 Publishing a New Version

After collecting contributions, an admin can publish a new version of the document. The admin should click Edit and consolidate all the contributions into a new draft. Once all the changes are made the admin clicks OK. Next the admin clicks the Revisions link, and clicks the button next to the version they have edited under the Live Revision heading to publish the new version.