document Diarmuid's importer and game architecture