This repository has been archived on 2025-06-27. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
ludusavi-manifest/CONTRIBUTING.md

1.3 KiB

Development

Requires Node.js.

  • Add new games to wiki-game-cache.yaml (required in order to add them to the manifest):
    • npm run cache
  • Update the manifest with games from the cache (--limit 25 is default at a time):
    • All games in cache: npm run manifest -- --all
    • Games already in the manifest: npm run manifest -- --existing
    • Games missing from manifest: npm run manifest -- --missing
    • Games not yet checked on the wiki: npm run manifest -- --unchecked
    • Games that had an unknown OS: npm run manifest -- --unsuportedOs
    • Games that had an unusable path: npm run manifest -- --unsupportedPath
    • A specific game: npm run manifest -- --game "Name of Game"
  • Validate the manifest against the schema:
    • npm run schema

API etiquette

When running or modifying the importer script, please be mindful not to unnecessarily spam the PCGW or Steam APIs.

The Mediawiki guidelines suggest that:

Making your requests in series rather than in parallel, by waiting for one request to finish before sending a new request, should result in a safe request rate.

I am not sure about guidelines for the Steam API, but the cache file should mean that we only ever need to reach out to Steam once per game.