Guide:Issue reports

From TurfWiki

This guide shows you how to make an issue report in Turf Game Issue Tracking, the system at issues.turfgame.com. It also covers how to comment on issue reports made by others, and how to get mail when new ones appear.

In short

  1. Log in at Turfgame.com. You cannot create an issue report without being logged in.
  2. Pick ISSUES in the menu, or go straight to issues.turfgame.com. Your login follows you there.
  3. Click Report and pick the category that fits best.
  4. Describe the problem and click Submit.
  5. Wait until the Creating your issue box goes away. It can take up to a minute.
  6. Pictures and other files are added afterwards, on the issue report's own page.

The rest of this page is the detail.

You have to be logged in

Reading issue reports works without logging in. Creating one does not, and neither does commenting on an existing report or subscribing.

If you are not logged in, all you get where the form should be is Login required, and the menu shows only Browse and Login.

It is your ordinary Turf account, the same login as on turfgame.com. If you are already logged in there you are logged in on the issue tracker too. Otherwise click Login.

What you can report

Issue reports are made when something in the game does not work as expected: the apps, user accounts, the website, and so on.

You can also report turf zones, for example if a zone is in an unsuitable or unreachable place. Read more about zone location.

Issue reports are also used to claim the Expandator medals. How that works is described under each medal.

Pick a category

Click Report. You then choose what the issue report is about.

The categories you can choose from.

If the report ends up in the wrong category it is no problem. It can be moved afterwards.

Category Used for
Zone Problem with a single zone, for example that it is in an unsuitable or unreachable place.
Android App Problem with the Android app.
iOS App Problem with the iOS app.
Game Server & API Problem with the game server or the public API.
Turfgame.com Website Problem on the turfgame.com website.
Medal Claims & Missing Medals A medal that was not awarded, or a medal you want to claim.
Event Problem with an event.
Turf Wiki Problem with the Turf Wiki.
Discord Problem on Turf's Discord server.
Issue Tracker Problem with the issue tracking system itself.
Turfa.nu Problem with turfa.nu.

Zones: search first

If you pick Zone you get a search box first. Type the name of the zone and click Search for issues.

The search shows every issue report about the zone, closed ones included. That is the whole point of it. If someone has already argued that the zone is in a bad spot, you can open that report and read what was decided, instead of the same question being looked into all over again.

This zone already has an issue report. Click it to read it.

If an open report is about the same thing you were going to report, write your comment there instead of creating another one. See Comment on an existing issue report.

If the question is already settled in a closed report, there is no need to raise it again. If you have something new that changes the picture, create a new report and refer to the old one by its number.

If it is a different problem with the same zone, click Report new issue with this zone. One issue report covers one thing, so two different problems with the same zone are two reports.

The other categories have no search box and take you straight to the form.

Fill in the form

A good issue report contains:

  • One thing per report. Two problems in the same report are hard to follow up and to close.
  • What you did, step by step, so someone else can do the same.
  • What happened and what you expected instead.
  • When it happened, if it was at a particular moment.
  • Which phone and which version of Turf you use. The version is in the app settings.
  • A screenshot often says more than a description.
The form. The fields differ a little between categories.

Click Submit when you are done. A box then appears while the issue report is being created. It can take up to a minute. Do not reload the page and do not close the window while the box is showing.

The box shown while the issue report is being created.

Attachments

Files are added after the issue report has been created, on the report's own page. Drop the file on the dashed area, or click the area to pick a file.

Each file may be at most 10 MB. If you have a larger video or picture, post it in the issue-media channel on Turf's Discord and paste the link into the issue report.

Comment on an existing issue report

Open the issue report and you can see what others have written. At the bottom of the page you can write your own comment and attach a file. A closed report cannot be commented on, only read.

There are also two boxes to tick:

  • I'm also affected by this issue if you have the same problem.
  • I think this is an important issue if you think it is urgent.

You can tick one or both without writing anything. Click Submit to send it in.

Subscribe to issue reports

You can get mail when a new issue report is created. Click Subscriptions.

The subscriptions page has two parts.

Under Issue types you tick the categories you want mail about.

Under Zone regions you can instead follow single regions. Mark a region in the lower box and click Subscribe, and it moves up to the upper one. If you change your mind, mark it in the upper box and click Unsubscribe. In Sweden you can pick single municipalities instead of a whole region.

If you tick the Zone category you get mail about every new zone report in the whole world. Zone regions is then greyed out, since single regions add nothing. If you only want to follow certain regions, untick Zone first.

To end the subscription completely: untick all categories, mark everything in the upper region box and click Unsubscribe.

See also

External links