Aircraft metadata checklist

From FlightGear wiki
Revision as of 08:22, 26 May 2020 by Zakalawe (talk | contribs)
Jump to navigation Jump to search

This list is various simple checks and modifications to improve user experience with aircraft.

(For each of these items, we need to show an example of the XML changes required)


Metadata / -set.xml

Checking / fixing these items should take about 30 minutes per aircraft (maybe a little longer the first time)

For full description of each item, see aircraft -set.xml description

  • Ensure the aircraft ratings are set and not wildly inaccurate.
  • Ensure any tags are from the official list of tags: catalogTags.py
  • Ensure the aircraft has a suitable name and description
  • For multi-variant aircraft, ensure the primary aircraft is a sensible choice (eg not a copilot or floats/skis variant), and that other variants declare a 'variant-of' referencing the primary

In the primary: (eg in f16-block-52-set.xml)

<sim>
   <primary-set type="bool">true</primary-set>
</sim>

In the variants: (eg in f16-block-10-set.xml)

<sim>
    <variant-of>f16-block-52</variant-of>
</sim>
  • Add new-style preview images
  • Ensure the thumbnail is the correct size and follows the guidelines (not a logo, not a photograph)

(Insert the basic thumbnail size here)

  • Set minimum-fg-version and compatible-fg-version values in the -set.xml if required
  • Review the 'catalog generator' error messages for the aircraft (eg, XML formatting errors)
  • Ensure any development files are excluded from the generated .zip (eg XCF or PSD files)
  • Examine the console log and resolve any reported aircraft issues (e.g. PNG bad color profile, missing files, etc.)

[need to document options to do this]

  • Add an appropriate MP fallback model

Code changes

  • Ensure the aircraft uses the global property for enabling/disabling the pilot model.
  • ?