User Tools

Site Tools


pergamonmystic:linkedhelp:crows-nest

This is an old revision of the document!


The Crow's Nest

What is the Crow's Nest

The Crow's Nest is a means by which suitably authorised end-users (usually those with permissions to access the [Staff] > [Tools] menu area) can send observations, technical issues and requests for change directly to Esferico or their 1st line support provider (for schools, usually an SLS).

The Crow's Nest operates in a similar way to an online Forum - you can create a new discussion, an initial post or body text containing the more detailed information about the report, and continue to add reports in discussion with Esferico or other users of the Mystic application.

What should I report via the Crow's Nest?

The Crow's Nest is principally for three types of report, all of which refer to the actual technical means in which Mystic / Pergamon operates and not the procedural mechanism which you may have learned during training.

  • Observations - Strange behaviours, Mystic not performing as expected on certain operating systems or browsers etc.
  • Technical Support Issues - You know Mystic works in a particular way, but clicking a button, selecting a menu item etc. is not doing what you know Mystic should be doing.
  • Requests for Change (RFCs) - You need a new function or a change to an existing function and would like to request the change.

What should I NOT report via the Crow's Nest?

Your 1st line procedural support is usually provided by whoever originally provided your Mystic or Pergamon license. In the case of schools for example, this is usually an SLS (Schools's Library Service) or the organisation providing this service. SLS's usually do far more than just support Mystic and Pergamon and therefore will not be monitoring The Crow's Nest continually.

If you need procedural help (e.g “How do I do such-and-such?”), your current contact method is still the best option (e.g. Telephone).

Before I report, what should I do?

Remember that Mystic is an online application - which means that if someone reports a problem, any fix / change that the development team come up with will reach everybody at the same time. You don't need to do anything to upgrade the software yourself.

Just as with using a normal Forum therefore, it is a good idea to search The Crow's Nest first to see if someone has already reported it. You can do this by just entering some relevant words into the Search bar (separated by commas if you want the words/phrases to be regarded as different terms) and click [Search]. If someone has reported it, you can read any progress that has been made (double click the displayed result) and contribute to the conversation, without needing to create a new report.

Using The Crow's Nest Main Window

The main Crow's Nest window is a very simple search results display. There are three ways to see results.

  • Search - Enter one or more search terms into the criteria field (separated by commas) and click the [Search] button or toolbar. Anything matching your search terms will be displayed.
  • Followed - Just click this button if you want to see any Reports that you are already following. You can follow a report by clicking the [Follow] button (see below), but if you add a comment onto a report then The Crow's Nest will automatically put you on the Following list.
  • Clients - If you are a provider of support, clicking the [Clients] toolbar button will display all reports that are current for any of your users of Mystic.

Search results will show you some basic details about the report (e.g. the operating system and browser in use, and the title that the reporter created). If you are following the report, it will also show you whether there are new posts in the report (e.g. responses and contributions from other people) that you have not yet seen. If you used the [Clients] search option, it will also show you whether you are not yet following the report conversation.

In order to viBold Textew a report, double-click the entry in the list.

In order to create a new report, click the [Create] button in the toolbar.

Release Notes

If you want to see the release notes for your current version of Mystic (which has a summary of things that have been changed / fixed), either use the [About[ menu option from the main [Info] menu, or click the [Release Notes] toolbar button on this dialog.

Using The Reports Window

If you clicked the [Create] toolbar button, or double-clicked a result to view it's contents, you will be presented with the Report Window.

Creating a new report

If you are creating a new report, most of this window will be initially empty. Mystic will however, auto-complete many of the fields for you such as the Operating System that you are using (or Platform, such as Windows), the Browser being used, the HTML Engine (unless you are technical, ignore this - it's important for us but most end users won't care) and different version information of your Browser and Mystic.

You do not need to change any of this information, unless you are reporting an issue on a different machine to where the issue was taking place.

To complete the report, finish four required pieces of information:

Area

Select the area from the list that best describes the area of Mystic that you are reporting on. Some windows do not always fit into a particular recognised area, so select the way you got here / what you were intending to do etc. You can always give more details in your first post, below.

Function

Once you have selected the Area, choose the function that your report refers to. Again, some things to not fit into a particular area so you can always choose 'other' and give more details in your first post.

Title

Your title is usually the first point-of-call for others also searching for information about a particular report - help us and them out by providing a short(ish) title that best describes your report.

First Post (Body Text)

Add more details in your first post. There is no real limits in this one, so you can be as detailed as you want to be. In an observation etc. you can describe everything that you were doing and what happened; in an RFC, you can describe everything that you would like to see in the new / changed function, and why it is important.

Once you have completed the four parts, click [Update] to save the new report. As the creator, you will automatically be set to [Follow] the report.



Mystic Linked Help Index
Pergamon Wiki Home

pergamonmystic/linkedhelp/crows-nest.1581333985.txt.gz · Last modified: 2020/02/10 11:26 by admin