Windows on Arm Ready Software

Contributing to this site

How to contribute via Microsoft Forms

Fill out the below form with your game test details. We recommend you contribute via the Microsoft Form and not via the Github unless you have some technical experience. Scroll down to see more details on the defined schema and category definitions.

Click here to open the MS Form directly

How to contribute via GitHub

You will need your own GitHub account. If you do not already have one, go to https://github.com, click on Sign up in the top right corner of the page and follow the instructions from there.

Once you have your account, go to https://github.com/Linaro/works-on-woa/fork to fork (i.e. make your own copy) of the repository for this website.

Once you have forked the repository, clone it to your computer with the git clone command. See https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository for more guidance if you need it.

NOTE: You need to clone the repository into WSL (Windows Subsystem for Linux). The repository will not build locally unless it is in WSL.

Once you have cloned the repository, make the necessary changes to the files. Guidance can be found below on the contents required and optional for each of the different files. If you need help, please create an issue via https://github.com/Linaro/works-on-woa/issues/new and we’ll do our best to help.

When you’ve made your changes, commit them to your own repository and then push them back to GitHub.

Finally, create a Pull Request to ask for your changes to be merged into the official repository. Your request will be reviewed and, if approved, merged into the site.

PLEASE NOTE! It is strongly recommended that you try to build the website locally on your computer before pushing changes back to GitHub. This will ensure that the site builds correctly and you do not have any errors in your contribution. Please see the section Developer Info in the README file for instructions on how to do this.

File content details

For games, there is a defined schema to ensure consistency of data across the submissions.

Each entry is stored in a file with a .md file extension. Game entries are stored under src/content/games.

If you are contributing your own report on an existing entry, it should be stored under src/content/user_reports_games.

Each file consists of:

Games schema

FieldTypeNotes
namestringThe name of the game.
iconstringOptional. The path to the icon file to use, relative to public/icons. 512x512 maximum. Use SVG if possible.
categorieslistA list of one or more categories that the game belongs to. A list of categories can be found in src/content/gamess_categories. Categories are referenced by their file name in this folder.
publisherstringOptional. The name of the game’s publisher.
frame_ratestringOptional. Frames per second of the game.
device_configurationstringOptional. Device used to test the game.
os_versionstringOptional. OS version used to test the game.
driver_idstringOptional. ID of graphics driver used to test the game.
date_testeddateOptional. Format is YYYY-MM-DD
compatibilityenum
  • perfect
  • playable
  • runs
  • unplayable
How well the game plays. See help page for more information on how these are defined.
compatibility_detailsstringOptional. Any additional information about the compatibility.
auto_super_resolutionblockOptional. See example below for syntax.
- compatibilityenum
  • yes, out-of-box
  • yes, opt-in
  • no
  • unknown
Optional. Indicates compatibility with Auto Super Resolution feature. Opt-in means you need to enable the feature in Windows Settings, and out-of-box means that Auto SR is applied without changing any settings.
- fps_booststringOptional. How much Auto SR boosts the frame rate of a game by.
- opt-in stepsstringOptional. Steps on how to enable Auto SR for games that are opt-in.
linkURLA link to where the software can be downloaded, or the application’s main website.

The auto_super_resolution block is optional but, if present, the attribute compatibility must be present. The block is formatted like this:

   auto_super_resolution:
      compatibility: yes, out-of-box

Games User Report schema

Users can add their own findings regarding a game that has been added to this site. The file can have any unique filename (with a .md extension) and the contents must follow this schema:

FieldTypeNotes
reporterstringOptional. Your name.
gamestringThe name of the game from its own filename, i.e. without the .md extension
device_configurationstringOptional. The name of the device that you used.
date_testeddateOptional. Format is YYYY-MM-DD
os_versionstringOptional. The OS version on your system.
driver_idstringOptional. The graphics driver id on your system.
compatibilityenum
  • perfect
  • playable
  • runs
  • unplayable
How well the game plays. See help page for more information on how these are defined.
compatibility_detailsstringYour report of how the application ran for you.
auto_super_resolutionblockOptional.
- compatibilityenum
  • yes, opt-in
  • no
  • unknown
Indicates compatibility with Auto Super Resolution feature. Opt-in means you need to enable the feature in Windows Settings.
- fps_booststringHow much Auto SR boosts the frame rate of a game by.
- opt-in stepsstringOptional. Steps on how to enable Auto SR for games that are opt-in.

Note that for user game reports, auto super resolution compatibility can only be yes, opt-in or no, or unknown.

Categories

For the game category list, this is constructed with an open square bracket [, one or more categories separated by commas, and a close square bracket ].

Categories must match the file name of an .md file in the appropriate categories folder as specified earlier.