Review - Revision history

Cclewley: /* Becoming a reviewer */

2021-10-01T12:32:19Z

Becoming a reviewer

← Older revision		Revision as of 12:32, 1 October 2021
Line 13:		Line 13:
	If you have not yet registered on the [https://impvis.co.uk ImpVis] website, the automated review email will ask you to [https://impvis.co.uk/signup sign up], which is a simple process. When you are an ImpVis user (i.e. registered on the ImpVis website), you have access to the '[https://impvis.co.uk/code/dashboard MyVis]' environment on the website.		If you have not yet registered on the [https://impvis.co.uk ImpVis] website, the automated review email will ask you to [https://impvis.co.uk/signup sign up], which is a simple process. When you are an ImpVis user (i.e. registered on the ImpVis website), you have access to the '[https://impvis.co.uk/code/dashboard MyVis]' environment on the website.

	When you are a reviewer for a visualisation, the visualisation will show up on your '[https://impvis.co.uk/code/dashboard MyVis]' dashboard, underneath your favourite visualisations and collections, as shown in the screenshot below.		When you are a reviewer for a visualisation, the visualisation will show up on your '[https://impvis.co.uk/code/dashboard MyVis]' dashboard, underneath your [[Favourite visualisations and Collections\|favourite]] visualisations and collections, as shown in the screenshot below.
	[[File:Dashboard for reviewer.png\|alt=Dashboard showing the visualisation awaiting your review under your favourite collections and visualisations.\|center\|thumb\|600x600px\|Dashboard showing the visualisation awaiting your review.]]		[[File:Dashboard for reviewer.png\|alt=Dashboard showing the visualisation awaiting your review under your favourite collections and visualisations.\|center\|thumb\|600x600px\|Dashboard showing the visualisation awaiting your review.]]
	You may note that if you have previously reviewed any visualisations, these will also remain on your dashboard under 'Your Past Approvals'.		You may note that if you have previously reviewed any visualisations, these will also remain on your dashboard under 'Your Past Approvals'.

Cclewley: /* Recording issues */

2021-09-29T16:54:00Z

Recording issues

← Older revision		Revision as of 16:54, 29 September 2021
Line 44:		Line 44:
	* Low priority: suggestions for further work or improvements		* Low priority: suggestions for further work or improvements
	* Medium priority: recommended improvements, either cosmetic or functional. these are issues that you think should be fixed, but the visualisation can be used by learners in the mean time. For example, text that overlaps graphics, typos in the text, small bugs that don't stop the visualisation from being used, etc.		* Medium priority: recommended improvements, either cosmetic or functional. these are issues that you think should be fixed, but the visualisation can be used by learners in the mean time. For example, text that overlaps graphics, typos in the text, small bugs that don't stop the visualisation from being used, etc.
	* High priority: critical issues that need to be fixed before the visualisation can be used by students, for example serious bugs or errors. The visualisation '''''cannot''''' '''''be published''''' with any outstanding high-priority issues - a new version will need to be uploaded and reviewed first.		* High priority: critical issues that need to be fixed before the visualisation can be used by students, for example serious bugs or errors. The visualisation '''''cannot''''' '''''be published''''' with any outstanding high-priority issues - a new version will need to be uploaded and reviewed first. Note that for this reason, high-priority issues can only be recorded for visualisations that are currently in review - for approved visualisations only low- and medium-priority issues are available.

	To record your issues, click on the 'Issues' tab on the top left of the page from which you launched the visualisation (see screenshot above). You will then see the following:		To record your issues, click on the 'Issues' tab on the top left of the page from which you launched the visualisation (see screenshot above). You will then see the following:

Cclewley at 16:50, 29 September 2021

2021-09-29T16:50:33Z

← Older revision		Revision as of 16:50, 29 September 2021
Line 1:		Line 1:
	~~'''The writers and peers'''~~		Any particular visualisation, or new version of an existing visualisation, must be reviewed before it is published on the website. This keeps up the quality of the content! When a creator [[Uploading a new visualisation\|uploads a visualisation]], they will specify reviewers. This should include at least one staff member - usually the staff partner of the project. Only when all reviewers have approved the visualisation can it be published on the website.

	~~Any particular~~ visualisation ~~must be reviewed before~~ it is ~~incorporated into~~ the ~~website. This keeps up~~ the ~~quality of the content~~! ~~Here is a set of questions a vis writer can ask as an initial review:~~		== Appointing reviewers ==
			The creator of the visualisation can appoint any existing ImpVis user as a reviewer for their visualisation, or invite new users to join ImpVis and review their visualisation (see [[uploading a new visualisation]] for how to do this). However, it is advisable that you only choose people who are expecting to review your visualisation, otherwise it is likely that they will not undertake the review and your visualisation will be stuck in the review stage!

	~~# Has~~ the ~~vis achieved the primary learning outcome?~~		When selecting reviewers, as well as including your project partners, it is useful if you can also get someone with “clean eyes”: either someone who has not seen the subject you’re trying to teach yet or someone who has not seen your visualization trying to teach the content you’re doing. Peers are an excellent choice! This peer review gives you feedback on how easy it is to understand what’s been said.
	~~# Is the vis physically correct~~ or ~~at least visually giving~~ the ~~right intuition?~~
	~~# Is~~ it ~~intuitive~~ to ~~use?~~

	~~And~~ for ~~a suite:~~		You can also appoint new reviewers or remove existing ones after the uploading process. The latter is advised if the reviewer is unresponsive. See [[Managing your visualisation#Reviewers and developers\|here]] for an explanation on how to do this.

	~~# Has~~ the ~~suite achieved secondary learning outcomes?~~		== Becoming a reviewer ==
	~~# Does every vis work correctly/~~the ~~way~~ you ~~want?~~		If you have been asked to review a visualisation, you will receive an automated email with a link to the visualisation to review. '''''Please be aware that the visualisation cannot be published until you have finished your review!''''' If you do not wish to undertake this task, do let the visualisation creator know so they can appoint somebody else.
	~~# Does it flow?~~
	~~# Is it easy~~ to ~~follow through?~~

	~~(Bug check~~: ~~Have~~ you ~~looked into exceptional cases if they exist?~~)		If you have not yet registered on the [https://impvis.co.uk ImpVis] website, the automated review email will ask you to [https://impvis.co.uk/signup sign up], which is a simple process. When you are an ImpVis user (i.e. registered on the ImpVis website), you have access to the '[https://impvis.co.uk/code/dashboard MyVis]' environment on the website.

	~~At this point, it’s best if~~ you ~~can get someone with “clean eyes~~,~~” either someone who has not seen~~ the ~~subject you’re trying to teach yet or someone who has not seen~~ your ~~visualization trying to teach~~ the ~~content you’re doing~~. ~~Peers are an excellent choice! This peer~~ review ~~gives~~ you ~~feedback~~ on ~~how easy it is to understand what’s been said~~.		When you are a reviewer for a visualisation, the visualisation will show up on your '[https://impvis.co.uk/code/dashboard MyVis]' dashboard, underneath your favourite visualisations and collections, as shown in the screenshot below.
			[[File:Dashboard for reviewer.png\|alt=Dashboard showing the visualisation awaiting your review under your favourite collections and visualisations.\|center\|thumb\|600x600px\|Dashboard showing the visualisation awaiting your review.]]
			You may note that if you have previously reviewed any visualisations, these will also remain on your dashboard under 'Your Past Approvals'.

			You can click 'View' to see the visualisation you have been asked to review. You will see the following screen:
			[[File:Reviewing a visualisation.png\|alt=Reviewer's view of the visualisation to review\|center\|thumb\|600x600px\|Reviewer's view of the visualisation to review]]
			Here you can see the details of the visualisation you are reviewing. Note at the top left that you are currently in the 'Overview' tab - you will need to return to this tab later when you have finalised your review. Now, to launch the visualisation, press the 'Launch' button - the visualisation itself will open in a new tab.

			== Undertaking the review ==
			After launching the visualisation, you can explore the visualisation in one browser tab whilst recording any issues you encounter in the other.

	~~'''Consulting an academic'''~~		Here is a set of questions to consider when undertaking your review:

	~~<span style="color:red">This document~~ is ~~not quite complete~~, ~~needs expanidng on~~ the ~~sections~~ of~~</span>~~		# Does the visualisation achieve the intended learning outcomes? The intended learning outcomes should be listed on the visualisation's Wiki page - the URL is listed in the 'Overview' tab you launched the visualisation from. If you cannot find the learning outcomes, please contact the creator!
			# Is the visualisation intuitive to use? Is there a clear learning journey for the learner to follow?
			#Is the text accompanying the visualisation clear and correct?
			#Are there any bugs or mistakes? Does the visualisation work correctly for extreme cases of input values?
			#Is there any way in which the visualisation could be improved?

	* 1.) How to ~~ask for help~~		If you are a staff partner on the project reviewing the visualisation, your review is very important: it is your responsibility to check that:
	* 2.) What to ask them to consider
	* 3.) Dealing with feedback

	~~By now, lecturers for~~ the ~~course you’re teaching~~, or ~~people who may~~ be ~~interested in showing~~ this ~~content~~ to students should be ~~contacted~~, ~~asking if they’re interested~~ in ~~hearing~~ your ~~ideas~~ on ~~how you’re visualizing~~ the ~~content~~ of the ~~suites~~. ~~Showing them what~~ you have/what ~~you’re planning~~ to have at this ~~sort of stage is crucial~~, as it ~~stops~~ you ~~moving too far without~~ any ~~misconceptions~~. You ~~might find it surprising how many incorrect ideas make it this far~~, ~~where it takes a lecturer~~ to ~~catch out~~ any ~~inconsistencies!~~		# the visualisation is physically/mathematically correct, or at least visually gives the right intuition (approximations be used rather than exact models, this is fine as long as it leads the learner to the correct conclusions).
			# the visualisation is suitable for your intended implementation, i.e. it is at the right level for your students and fits within the learning setting you want it to be used in.

			If you encounter any issues with the visualisation that you wish to feed back, please read the following section. If you have not found any issues and have no suggestions for further work, skip ahead to [[Review#Finishing your review\|Finishing your review]].

			== Recording issues ==
			When you encounter any issues or would like to feed back suggestions for future work, please think carefully about their priority:

			* Low priority: suggestions for further work or improvements
			* Medium priority: recommended improvements, either cosmetic or functional. these are issues that you think should be fixed, but the visualisation can be used by learners in the mean time. For example, text that overlaps graphics, typos in the text, small bugs that don't stop the visualisation from being used, etc.
			* High priority: critical issues that need to be fixed before the visualisation can be used by students, for example serious bugs or errors. The visualisation '''''cannot''''' '''''be published''''' with any outstanding high-priority issues - a new version will need to be uploaded and reviewed first.

			To record your issues, click on the 'Issues' tab on the top left of the page from which you launched the visualisation (see screenshot above). You will then see the following:
			[[File:Issues list.png\|alt=Issues list - record new issues here.\|center\|thumb\|600x600px\|Issues list - record new issues here.]]
			At the top, the three priorities are summarised. Below that, you can see any issues that have been raised already - do read through these to check whether somebody else has already recorded the issue you found. At the bottom, you can record new issues. Type the description of your issue in the textbox - please be specific so that it is clear for the developers when or where your issue occurs, or what exactly you think should be included in any future improvements. Below the description, specify the priority (low, medium, or high) from the dropdown box before pressing 'Submit'.

			You can edit or delete issues you recorded by pressing the pencil symbol or the cross symbol next to the issue.

			Every time you record an issue, the developer(s) will be notified by email.

			== Finishing your review ==
			When you have finished your review, you need to click the green 'Finish review' button in the 'Overview' tab as shown in the screenshot above. At this point, the developers will be notified that you have finished your review. You can still resume your review as long as the visualisation remains 'in review' (i.e. it isn't approved yet) by clicking the 'Resume review' button. If the visualisation is already approved, you will not have the option to resume your review.

			Once all reviewers have finished their review and if only low- and medium-priority issues (or none at all) have been recorded, the visualisation is approved. It will now be published automatically to the '[https://impvis.co.uk/teach Teach]' environment of the website. If any high-priority issues were raised, the visualisation will not be approved. The developer will need to upload a new version; they will specify which issues they resolved in the new version and you will be asked to review the latest version again to ensure you are satisfied.

			== Past approvals ==
			Any visualisations you have previously approved are shown at the bottom of your '[https://impvis.co.uk/code/dashboard MyVis]' dashboard, under 'Past Approvals'. You can still view these visualisations and record issues, though you will not be able to record any high-priority issues.

			[[Category:ImpVis Website Guidance]]

Mark Thomas at 19:05, 16 July 2021

2021-07-16T19:05:52Z

← Older revision		Revision as of 19:05, 16 July 2021
Line 21:		Line 21:

	'''Consulting an academic'''		'''Consulting an academic'''

	<span style="color:red">This document is not quite complete, needs expanidng on the sections of</span>		<span style="color:red">This document is not quite complete, needs expanidng on the sections of</span>

			* 1.) How to ask for help
			* 2.) What to ask them to consider
			* 3.) Dealing with feedback

			By now, lecturers for the course you’re teaching, or people who may be interested in showing this content to students should be contacted, asking if they’re interested in hearing your ideas on how you’re visualizing the content of the suites. Showing them what you have/what you’re planning to have at this sort of stage is crucial, as it stops you moving too far without any misconceptions. You might find it surprising how many incorrect ideas make it this far, where it takes a lecturer to catch out any inconsistencies!

Mark Thomas at 19:05, 16 July 2021

2021-07-16T19:05:19Z

← Older revision		Revision as of 19:05, 16 July 2021
Line 21:		Line 21:

	'''Consulting an academic'''		'''Consulting an academic'''
			<span style="color:red">This document is not quite complete, needs expanidng on the sections of</span>
	This document is not quite complete, needs expanidng on the sections of

Mark Thomas at 19:04, 16 July 2021

2021-07-16T19:04:52Z

← Older revision		Revision as of 19:04, 16 July 2021
Line 1:		Line 1:
	~~asd~~		'''The writers and peers'''

			Any particular visualisation must be reviewed before it is incorporated into the website. This keeps up the quality of the content! Here is a set of questions a vis writer can ask as an initial review:

			# Has the vis achieved the primary learning outcome?
			# Is the vis physically correct or at least visually giving the right intuition?
			# Is it intuitive to use?

			And for a suite:

			# Has the suite achieved secondary learning outcomes?
			# Does every vis work correctly/the way you want?
			# Does it flow?
			# Is it easy to follow through?

			(Bug check: Have you looked into exceptional cases if they exist?)

			At this point, it’s best if you can get someone with “clean eyes,” either someone who has not seen the subject you’re trying to teach yet or someone who has not seen your visualization trying to teach the content you’re doing. Peers are an excellent choice! This peer review gives you feedback on how easy it is to understand what’s been said.



			'''Consulting an academic'''

			This document is not quite complete, needs expanidng on the sections of

Mark Thomas: Created page with "asd"

2021-07-16T19:03:52Z

Created page with "asd"

New page

asd