Managing your visualisation - Revision history

Cclewley: /* Amending your visualisation details */

2021-09-30T15:06:11Z

Amending your visualisation details

← Older revision		Revision as of 15:06, 30 September 2021
Line 7:		Line 7:

	== Amending your visualisation details ==		== Amending your visualisation details ==
	The 'Make Changes' button allows you to amend the title of your visualisation, the author(s), the description, the concept tags and its topic categories. You can also insert or alter the URL to the visualisation's own Wiki page and set the 'Beta' flag. Further descriptions of these fields can be found [[~~Index.php?title=~~Uploading a new visualisation#Upload~~%20your%20files~~\|here]].		The 'Make Changes' button allows you to amend the title of your visualisation, the author(s), the description, the concept tags and its topic categories. You can also insert or alter the URL to the visualisation's own Wiki page and set the 'Beta' flag. Further descriptions of these fields can be found [[Uploading a new visualisation#Upload your files\|here]].

	Under the image of your visualisation, you can find its current [[Visualisation status\|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.		Under the image of your visualisation, you can find its current [[Visualisation status\|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.

Cclewley: /* Further reading */

2021-09-29T16:55:06Z

Cclewley: /* Reviewers and developers */

2021-09-29T16:52:48Z

Reviewers and developers

← Older revision		Revision as of 16:52, 29 September 2021
Line 32:		Line 32:
	You can record any issues you find here yourself as well - this is a great way or keeping a record of fixes you still want to implement, or would like to pass on to future developers.		You can record any issues you find here yourself as well - this is a great way or keeping a record of fixes you still want to implement, or would like to pass on to future developers.

	Read more about recording issues [[Recording issues ~~for visualisations~~\|here]].		Read more about recording issues [[Review#Recording issues\|here]].

	== Reviewers and developers ==		== Reviewers and developers ==

Cclewley: /* (Un)publishing your visualisation */

2021-09-29T15:46:20Z

(Un)publishing your visualisation

← Older revision		Revision as of 15:46, 29 September 2021
Line 11:		Line 11:
	Under the image of your visualisation, you can find its current [[Visualisation status\|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.		Under the image of your visualisation, you can find its current [[Visualisation status\|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.

	== ~~(Un)publishing~~ your visualisation ==		== Unpublishing your visualisation ==
	When your visualisation is first approved, it will automatically be published on the 'Teach' environment of the website. However, if for any reason you do not wish it to appear on the 'Teach' environment, you can click the 'Unpublish' button. Your visualisation will remain on the system, but will not be shown on the 'Teach' environment. Note however that it can still be included in Collections on the 'Learn' environment; if it is part of a Collection, unpublishing will '''''not''''' remove it from this Collection.		When your visualisation is first approved, it will automatically be published on the 'Teach' environment of the website. However, if for any reason you do not wish it to appear on the 'Teach' environment, you can click the 'Unpublish' button. Your visualisation will remain on the system, but will not be shown on the 'Teach' environment. Note however that it can still be included in Collections on the 'Learn' environment; if it is part of a Collection, unpublishing will '''''not''''' remove it from this Collection.

Cclewley at 15:25, 29 September 2021

2021-09-29T15:25:58Z

← Older revision		Revision as of 15:25, 29 September 2021
Line 10:		Line 10:

	Under the image of your visualisation, you can find its current [[Visualisation status\|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.		Under the image of your visualisation, you can find its current [[Visualisation status\|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.

			== (Un)publishing your visualisation ==
			When your visualisation is first approved, it will automatically be published on the 'Teach' environment of the website. However, if for any reason you do not wish it to appear on the 'Teach' environment, you can click the 'Unpublish' button. Your visualisation will remain on the system, but will not be shown on the 'Teach' environment. Note however that it can still be included in Collections on the 'Learn' environment; if it is part of a Collection, unpublishing will '''''not''''' remove it from this Collection.

			If you wish to publish your visualisation again on the 'Teach' environment, simply press the 'Publish' button.

	== Visualisation version history ==		== Visualisation version history ==

Cclewley: /* Visualisation version history */

2021-09-29T15:10:23Z

Visualisation version history

← Older revision		Revision as of 15:10, 29 September 2021
Line 14:		Line 14:
	You can view the version history of your visualisation by clicking on the 'Versions' tab at the top of the page. You should now see a screen similar to the below:		You can view the version history of your visualisation by clicking on the 'Versions' tab at the top of the page. You should now see a screen similar to the below:
	[[File:Version history.png\|alt=Version history of a visualisation\|center\|thumb\|600x600px\|Version history of a visualisation]]		[[File:Version history.png\|alt=Version history of a visualisation\|center\|thumb\|600x600px\|Version history of a visualisation]]
	Here you can see each version that has been uploaded for this visualisation. For each version, you can see who uploaded it, along with the upload message specifying the implemented changes for the new version. You can launch or download each different version of the visualisation. The [[Visualisation status\|status]] of each version is shown: only the latest 'approved' version will be published in the 'Teach' environment of the website (although previously approved versions may still show up in Collections in the 'Learn' environment - read more [[Managing your Collection\|here]]). In the green box, you can see which of the reviewers finished their reviews and which are still outstanding - if reviewers are unresponsive we suggest you remind them or assign a different reviewer as otherwise your visualisation will not be published on the website. For visualisations with multiple HTML files, the 'index' file (i.e. the file that will be shown when a user launches the visualisation) can be changed in the dropdown box.		Here you can see each version that has been uploaded for this visualisation. For each version, you can see who uploaded it, along with the upload message specifying the implemented changes for the new version. You can launch or download each different version of the visualisation. The [[Visualisation status\|status]] of each version is shown: only the latest 'approved' version will be published in the 'Teach' environment of the website (although previously approved versions may still show up in Collections in the 'Learn' environment - read more [[Managing your Collection\|here]]).

			In the green box, you can see which of the reviewers finished their reviews and which are still outstanding - if reviewers are unresponsive we suggest you remind them or assign a different reviewer as otherwise your visualisation will not be published on the website. For visualisations with multiple HTML files, the 'index' file (i.e. the file that will be shown when a user launches the visualisation) can be changed in the dropdown box.

	You can also [[Uploading a new version of your visualisation\|upload a new version]] of your visualisation on this page by clicking the 'Upload New Version' button at the top right.		You can also [[Uploading a new version of your visualisation\|upload a new version]] of your visualisation on this page by clicking the 'Upload New Version' button at the top right.

Cclewley: /* Reviewers & developers */

2021-09-29T15:08:33Z

Reviewers & developers

← Older revision		Revision as of 15:08, 29 September 2021
Line 27:		Line 27:
	Read more about recording issues [[Recording issues for visualisations\|here]].		Read more about recording issues [[Recording issues for visualisations\|here]].

	== Reviewers & developers ==		== Reviewers and developers ==
	The reviewers & developers tab at the top of the page shows you who are currently specified as reviewers and developers for this visualisation. These people have permissions to view your visualisation even when it is not yet published on the website. If you click the tab, you will see the following screen:		The reviewers & developers tab at the top of the page shows you who are currently specified as reviewers and developers for this visualisation. These people have permissions to view your visualisation even when it is not yet published on the website. If you click the tab, you will see the following screen:
	[[File:Reviewers and Developers.png\|alt=Reviewers and Developers page screenshot\|center\|thumb\|600x600px\|The Reviewers & Developers page]]		[[File:Reviewers and Developers.png\|alt=Reviewers and Developers page screenshot\|center\|thumb\|600x600px\|The Reviewers & Developers page]]

Cclewley: /* Further reading */

2021-09-29T15:03:55Z

Cclewley: Created page with "The visualisation management environment Once you have Uploading a new visualisation|upl..."

2021-09-29T15:03:13Z

Created page with "alt=The visualisation management environment|thumb|The visualisation management environment Once you have Uploading a new visualisation|upl..."

New page

[[File:Manage visualisation.png|alt=The visualisation management environment|thumb|The visualisation management environment]]
Once you have [[Uploading a new visualisation|uploaded a visualisation]], you can manage your visualisation via the '[https://impvis.co.uk/code/visualisations My Visualisations]' link in your '[https://impvis.co.uk/code/dashboard MyVis]' portal on the website.

When you click on your visualisation, you will be presented with a visualisation management environment as shown in the screenshot to the right. This allows you to amend your visualisation details, publish/unpublish it (if approved), view its version history, view outstanding issues for your visualisation, specify reviewers and developers, or delete your visualisation altogether (this cannot be undone). You can also launch the visualisation or download the visualisation and source code zip files.

If your visualisation appears in any Collections, these will be listed at the bottom of the page. It is important to keep an eye on this when you consider implementing any changes: Collection owners may have good ideas for further improvements.

== Amending your visualisation details ==
The 'Make Changes' button allows you to amend the title of your visualisation, the author(s), the description, the concept tags and its topic categories. You can also insert or alter the URL to the visualisation's own Wiki page and set the 'Beta' flag. Further descriptions of these fields can be found [[Index.php?title=Uploading a new visualisation#Upload%20your%20files|here]].

Under the image of your visualisation, you can find its current [[Visualisation status|status]] as well as other details. Note that if your visualisation has been published, there will be a link to a GitHub repository: all visualisations are automatically pushed to a GitHub repo that holds the latest published version of the visualisation, so that future developers can easily access the code.

== Visualisation version history ==
You can view the version history of your visualisation by clicking on the 'Versions' tab at the top of the page. You should now see a screen similar to the below:
[[File:Version history.png|alt=Version history of a visualisation|center|thumb|600x600px|Version history of a visualisation]]
Here you can see each version that has been uploaded for this visualisation. For each version, you can see who uploaded it, along with the upload message specifying the implemented changes for the new version. You can launch or download each different version of the visualisation. The [[Visualisation status|status]] of each version is shown: only the latest 'approved' version will be published in the 'Teach' environment of the website (although previously approved versions may still show up in Collections in the 'Learn' environment - read more [[Managing your Collection|here]]). In the green box, you can see which of the reviewers finished their reviews and which are still outstanding - if reviewers are unresponsive we suggest you remind them or assign a different reviewer as otherwise your visualisation will not be published on the website. For visualisations with multiple HTML files, the 'index' file (i.e. the file that will be shown when a user launches the visualisation) can be changed in the dropdown box.

You can also [[Uploading a new version of your visualisation|upload a new version]] of your visualisation on this page by clicking the 'Upload New Version' button at the top right.

== Issues ==
Clicking the 'Issues' list at the top of the page allows you to view outstanding issues and record new issues. You will see the following screen:
[[File:Issues list.png|alt=The issues list|center|thumb|600x600px|The issues list of your visualisation]]
The issues list shows every issue recorded by developers, reviewers, or users of the visualisation. There are three different priorities: 'low', 'medium', and 'high'. Any issues of 'high' priority will stop the visualisation from being approved and published - these will need to be fixed plus a new version uploaded and reviewed, before the visualisation will appear on the 'Teach' environment of the website.

You can record any issues you find here yourself as well - this is a great way or keeping a record of fixes you still want to implement, or would like to pass on to future developers.

Read more about recording issues [[Recording issues for visualisations|here]].

== Reviewers & developers ==
The reviewers & developers tab at the top of the page shows you who are currently specified as reviewers and developers for this visualisation. These people have permissions to view your visualisation even when it is not yet published on the website. If you click the tab, you will see the following screen:
[[File:Reviewers and Developers.png|alt=Reviewers and Developers page screenshot|center|thumb|600x600px|The Reviewers & Developers page]]
People listed as reviewers are shown on the left, together with whether they are students or staff. This is relevant, because your visualisation will need to be reviewed by at least one staff member. You can remove reviewers here by pressing the red 'x' next to their name. You can also add new reviewers, but '''''note that this will reduce the [[Visualisation status|status]] of your visualisation to 'in review'<nowiki/>'''.'' For this reason, you cannot add new reviewers to published visualisations (as in the screenshot above). You would first need to unpublish your visualisation, which should only be done with great caution as your visualisation may be in use in a Collection or by an instructor. If you think your visualisation needs additional review, a better option would be to [[Uploading a new version of your visualisation|upload a new version]]. This new version can then be reviewed whilst the old one remains published - only when the new version is approved will it supersede the old version.

If your visualisation is not yet published, you can add new reviewers from existing users or invite new reviewers by entering their email address. New reviewers are sent an automated email - you can add a personal message to this email if you wish by entering it in the 'Additional information for the reviewer' box (not shown in screenshot above).

Reviewers can view the details of your visualisation, launch it, and record issues; they cannot make any changes. Any ImpVis user can be selected as a reviewer. On the other hand, the developers listed on the right of your screen all have exactly the same permissions to the visualisation - each can access the full functionality of the visualisation management environment. You can add any user with creator permissions as a developer, but please do this with caution, bearing in mind the wide-ranging permissions (including deleting the visualisation!) they will be given. Removing a developer should only be done if you are sure they shouldn't be able to access the visualisation anymore, e.g. if they are no longer active within ImpVis.

== Further reading ==

* [[Visualisation status]]
* [[Uploading a new version of your visualisation]]
* [[Managing your Collection]]
* [[Review|The review process]]
* [[Recording issues]]

[[Category:ImpVis Website Guidance]]

← Older revision		Revision as of 16:55, 29 September 2021
Line 49:		Line 49:
	* [[Managing your Collection]]		* [[Managing your Collection]]
	* [[Review\|The review process]]		* [[Review\|The review process]]
	* [[Index.php?title=Recording issues for visualisations\|Recording issues for visualisations]]

	[[Category:ImpVis Website Guidance]]		[[Category:ImpVis Website Guidance]]

← Older revision		Revision as of 15:03, 29 September 2021
Line 42:		Line 42:
	* [[Managing your Collection]]		* [[Managing your Collection]]
	* [[Review\|The review process]]		* [[Review\|The review process]]
	* [[Recording issues]]		* [[Index.php?title=Recording issues for visualisations\|Recording issues for visualisations]]

	[[Category:ImpVis Website Guidance]]		[[Category:ImpVis Website Guidance]]