1 of 1 found this page helpful

Editing a Page

    Editing a Page

    Browse to the page of interest and click Edit Page on the page toolbar.

    edit-bar.jpg
    Page editing is only a click away

    You will now see a simple, but very sophisticated rich text (WYSIWYG) editor.  For more information on the functionality of the editor, take a look at our documentation.

    File:User:Coreyg/mt/User_Manual/Getting_Started/Editing_a_Page/editor.png 

    Edit Summary

    Note that at the bottom of the editor there is the following:

    File:User:Coreyg/mt/User_Manual/Getting_Started/Editing_a_Page/edit_summary.png 

    This is the Edit Summary which allows you to add details about the changes that you have made before saving. The edit summary is then visible in the page versioning along with other pages that show system changes like Recent Changes and Contributions.  Read more about versioning.

    Multiple Edits - Merge Conflicts

    MindTouch has a sophisticated merging engine that will recognize separate changes down to the word and accurately merge the revisions together. This helps with collaboration as there are less chances that if more than one user is editing a page there will be conflicts.

    First let’s examine at a high level how MindTouch handles a merge.

    Say you have the following set of sentences:

    The dog ran along the fence while the boy biked away.
    The boy was heading off to college to pursue his lifelong dream of being a developer.  

    Bob edits the first sentence to read this: The black dog ran along the white fence while the boy biked away.

    And Tim edits the second sentence to read: The boy was heading off to college to pursue his lifelong dream of being a baker.

    These edits occur at the same time but are saved at different times. Regardless of who started the edit first and who saved first, MindTouch will merge the sentences together to form a comprehensive set of sentences as it is intended:

    The black dog ran along the white fence while the boy biked away.
    The boy was heading off to college to pursue his lifelong dream of being a baker.

    This is also true on a Section and Page level.

    Now if Bob and Tim’s edits were to overlap then both edits will still be saved, but the last person to save will have the opportunity to review and compare the edits and confirm that nothing has been lost that should be kept.

    Example:

    Using the same sentences from above. Bob edits the first sentence to read:

    The black duck waddled next to the white fence while the boy biked away.

    While Tim edits the first sentence to read:

    The black cat walked on top of the white fence while the boy biked away.

    Bob saves his changes first which is accepted by the system. Tim saves his changes which is also accepted by the system. The system notices that there is some overlap and notifies Tim that there is a difference between his edit and what Bob had changed along with prompting him to compare versions to see the difference. This allows Tim to review Bob’s changes at a glance. If Bob’s changes need to be reincorporated, Tim can do so by re-edting the page. Otherwise Tim can also chose to leave the page as is.

    We have put a lot of work into our conflict merging to ensure that you don’t lose content and to maintain the integrity of edits so that they can be integrated manually by the user as opposed to removing the edit because of a conflict.

    Was this page helpful?
    Tag page

    Files 4

    FileVersionSizeModified 
    Viewing 2 of 2 comments: view all
    My Edit Page button is disabled. This topic should provide some guidance for enabling page edits. edited 04:35, 22 Sep 2011
    Posted 04:35, 22 Sep 2011
    @ddrahnak I'm assuming you've logged in already, correct? And you have permissions to edit? In other words, your role in MindTouch has editing rights but when you log in your edit button itself is not visible or cannot be clicked?
    Posted 07:11, 22 Sep 2011
    Viewing 2 of 2 comments: view all
    You must login to post a comment.

    Copyright © 2011 MindTouch, Inc. Powered by