<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Thanks for putting so much work into improving the quality of the data of the website!<div class=""><br class=""></div><div class="">Question: is the spreadsheet intended to be a solution long-term? If it’s a temporary measure as we’re migrating data, that’s fine. But I think long-term, we should have the relevant data in VCS under our control, rather than externally hosted on Google. This will ensure that there will never be access issues and that changes are properly tracked (as well as having our project built by FOSS at all levels).</div><div class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Sep 14, 2020, at 12:59 PM, Matan Bareket <<a href="mailto:mataniko@gmail.com" class="">mataniko@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class=""><div class="">If you do not add data to the website (demos, compatibility, etc.) you can skip reading this mail.</div><div class=""><br class=""></div><div class="">Over the last few months I've been working on improving the data behind our website culminating with <a href="https://github.com/scummvm/scummvm-web/pull/131" class="">https://github.com/scummvm/scummvm-web/pull/131</a> <br class=""></div><div class=""><br class=""></div><div class="">From now on, most data is managed via a spreadsheet, with a script to pull data into the repository to convert to YAML. You can find the new sheet here: <a href="https://docs.google.com/spreadsheets/d/1QzwFleEKXOsE59cYMOcQB7C2f0Np48uAQOCG8kicX_s/edit?usp=sharing" class="">https://docs.google.com/spreadsheets/d/1QzwFleEKXOsE59cYMOcQB7C2f0Np48uAQOCG8kicX_s/edit?usp=sharing</a><br class=""></div><div class=""><br class=""></div><div class="">Data is structured similar to a relational database, with sheets for games, companies, versions, engines, game series and demos. (More to be added).</div><div class=""><br class=""></div><div class="">When adding entries that reference other entities, please make sure you are not referencing a non-existing entity (sheets have some validation rules to help).</div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">Compatibility saw the most drastic change, since we now reuse old compatibility entries if they haven't changed. If you want to add a new entry:</div><div class="">1. Add a new line in the sheet</div><div class="">2. Fill up the id (game id), version the entry is relevant for, and supported platforms</div><div class="">3. Platforms are comma separated values, based on the platforms sheet</div><div class="">4. Optionally, add unsupported platforms</div><div class="">5. Optionally, add any additional notes - you DO NOT need to enter "game is supported, no problems" or "only dos version is supported" instead we will generate these messages based on the status and platforms</div><div class="">6. Once you're done - run the update script and commit the changes to the repository (composer update-data)</div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">Q&A</div><div class=""><br class=""></div><div class="">Q: This looks just like a database, why not use a database</div><div class="">A: I wanted to keep the data open, and not require us to build a whole setup to update the database. <br class=""></div><div class=""><br class=""></div><div class="">Q: Why do all this work?<br class=""></div><div class="">A: By using a "database" we can support more features in the site. Filtering, grouping, sorting, etc. It also keeps our data persistent across pages (demos, compat, eventually screenshots)</div><div class=""><br class=""></div><div class="">Q: I don't have access to the spreadsheet</div><div class="">A: Please reach out to me for access<br class=""></div></div>
_______________________________________________<br class="">Scummvm-devel mailing list<br class=""><a href="mailto:Scummvm-devel@lists.scummvm.org" class="">Scummvm-devel@lists.scummvm.org</a><br class="">https://lists.scummvm.org/listinfo/scummvm-devel<br class=""></div></blockquote></div><br class=""></div></body></html>