Commit a266cae7 authored by Kristina Hoeppner's avatar Kristina Hoeppner

blocks/general: Add information about peer assessment

New feature in Mahara 18.10: Add peer assessment
blocks to a page for a blind evaluation by a peer
(Bug #1784778).
parent 2f1b06f6
......@@ -123,6 +123,34 @@ Delete an annotation
When you delete an annotation, all its feedback is deleted as well. You cannot retrieve it again easily.
.. index::
pair: Blocks; Comments
single: General block; Comments
single: Comment block
.. _comments_block:
Comments
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-comment fa-border fa-2x`
You can move the comments section from the bottom of a page elsewhere onto your page to integrate it better with your page content. Please note the following:
* There is no configuration possible for this block.
* You only see comments when you display a page, but not in edit mode.
* You can only place 1 comment block onto a page.
* Comments for individual artefacts is still placed at the bottom of the artefact details pages because you cannot put a block onto these pages.
* You can move the block like any other block on your page. If you delete the block, the comments are displayed at the bottom of the page again.
.. figure:: /images/page_editor/blocks/comments_display.*
:alt: What the feedback block looks like on a page
What the feedback block looks like on a page
#. The block has the heading "Comments" unless your Mahara installation uses a different word.
#. When you click the *Add comment* link, a modal window is displayed in which you can :ref:`enter your comments <add_comment>` with all the usual functionality.
.. index::
pair: Blocks; Creative Commons license
single: General block; Creative Commons license
......@@ -161,34 +189,6 @@ Add a block to your page which lets users know under which `Creative Commons lic
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. index::
pair: Blocks; Comments
single: General block; Comments
single: Comment block
.. _comments_block:
Comments
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-comment fa-border fa-2x`
You can move the comments section from the bottom of a page elsewhere onto your page to integrate it better with your page content. Please note the following:
* There is no configuration possible for this block.
* You only see comments when you display a page, but not in edit mode.
* You can only place 1 comment block onto a page.
* Comments for individual artefacts is still placed at the bottom of the artefact details pages because you cannot put a block onto these pages.
* You can move the block like any other block on your page. If you delete the block, the comments are displayed at the bottom of the page again.
.. figure:: /images/page_editor/blocks/comments_display.*
:alt: What the feedback block looks like on a page
What the feedback block looks like on a page
#. The block has the heading "Comments" unless your Mahara installation uses a different word.
#. When you click the *Add comment* link, a modal window is displayed in which you can :ref:`enter your comments <add_comment>` with all the usual functionality.
.. index::
pair: Blocks; Group info
single: General block; Group info
......@@ -354,6 +354,10 @@ The *Inbox* block displays the latest messages that you have received.
#. **Block title**: The automatic title for this block is "Inbox". You can set another one if you wish.
#. **Message types to display**: Change the switch to "Yes" for each message type that you want to display in this block.
.. note::
All administration messages such as for objectionable content, virus upload, contact, etc. are all subsumed in "Administration messages".
#. **Maximum number of items to display**: Decide how many messages shall be shown on your dashboard. You can choose between 1 and 100.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
......@@ -596,6 +600,108 @@ You can re-use text from other note from one page in another without having to c
#. **Block content**: When you open a note that is used on a page that is currently submitted, you cannot make changes to the note.
#. Click the *Make a copy* link in order to make changes to this note on this page only. It is not changed on the other page that is submitted or on any other page where the text appears.
.. index::
pair: Blocks; Peer assessment
single: General block; Peer assessment
single: New in Mahara 18.10; Peer assessment
.. _peer_assessment_block:
|new in Mahara 18.10| Peer assessment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-list-alt fa-border fa-2x`
Allow peer reviewers to give blind feedback.
Add the peer assessment block to a page
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This block allows somebody else to provide blind feedback on the portfolio author, e.g. in a formal assessment context where skills and competencies need to be assessed by the peer independently of what the portfolio author has stated.
The peer reviewer can see block headings, but not the content in the blocks themselves. If the portfolio consists of multiple pages, and one of them does not contain a peer block, the peer reviewer does not see the page content at all.
.. note::
You must give a person the "Peer" role when sharing the portfolio page for them to be able to add their assessment.
.. figure:: /images/page_editor/blocks/peerassessment_configure.*
:alt: Configure the "Peer assessment" block
Configure the *Peer assessment* block
#. **Block title**: The title that you want to give this particular block.
#. **Instructions**: Provide instructions for the peer reviewer to help them with their assessment.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. _peer_assessor_setup:
Set up a peer assessor
^^^^^^^^^^^^^^^^^^^^^^^^^
You can give someone the peer assessment permissions on the *Edit access* screen of your portfolio page.
.. figure:: /images/page_editor/blocks/peerassessment_access.*
:alt: Give someone peer assessment permissions
Give someone peer assessment permissions
#. In the *Share with* drop-down menu, select "Users" under "Search for...".
#. In the second drop-down menu that becomes available, type the name of the person who shall be the peer assessor and select them.
#. In the third drop-down menu, select the "Peer" option. You can also select the "Peer and manager" option if the peer is also the manager and can verify the page in the end.
#. Click the *Save* button to keep your selection or click the *Cancel* link to abort your changes.
.. _peer_assessment_add:
Add a peer assessment
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Peer assessments are blind assessments at the moment allowing the peer assessor to give their feedback independently of the portfolio author.
.. figure:: /images/page_editor/blocks/peerassessment_add.*
:alt: Add a peer assessment
Add a peer assessment
When you are the peer assessor on someone's portfolio, and a page contains a peer assessment block, you can add your assessment by clicking the *Add peer assessment* link.
.. figure:: /images/page_editor/blocks/peerassessment_write.*
:alt: Write a peer assessment
Write a peer assessment
#. Click the *Instructions* link to view the instructions for the peer assessment.
#. Write your peer assessment.
#. Click the *Save draft* button if you are not yet ready for the portfolio author to view your assessment, and you want to save a draft status.
#. Click the *Publish* button when you finished your assessment, and the portfolio author can view it. A notification is also sent to the portfolio author.
.. note::
If the peer assessment block is used in conjunction with the sign-off block, the portfolio author must sign off the page before anybody other than themselves and the peer assessor can see published peer assessments.
.. _peer_assessment_view:
View a peer assessment
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If a peer assessment is in draft mode, only the peer assessor can see it. Once it's published, others can view it as well.
.. figure:: /images/page_editor/blocks/peerassessment_view.*
:alt: View a peer assessment
View a peer assessment
#. Click the *Add peer assessment* link if you want to add (another) peer assessment when you cannot edit an earlier one in the same block anymore.
#. The profile picture and name of the peer assessor are displayed along with the date and time when the peer assessment was made.
#. The peer assessment is displayed.
#. The *Edit* button |edit| is only displayed to the peer assessor for 10 minutes after publishing the assessment in case there are last minute changes they want to make.
#. The *Delete* button |delete| is only shown to the peer assessor, and they can delete their assessment at any point. If they do, the portfolio author receives an email about that with the text of the assessment included.
.. index::
pair: Blocks; Plans
single: General block; Plans
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment