Update README.md

.github/ISSUE_TEMPLATE/bug_report.md

@@ -13,8 +13,7 @@ assignees: ''
 ## Version of spice2x
 *version of spice, this can be seen in the About tab, and in log.txt*
 
-## Laptop
-*Are you running this on a laptop? Does it have a hybrid iGPU+ dGPU configuration?*
+*please remember to test the LATEST beta version before posting a bug about it**
 
 ## Describe the issue
 *what's the issue?*

CONTRIBUTING.md

@@ -17,6 +17,10 @@ Additionally, there's a lot of code that get exercised on specific hardware - in
 
 Therefore, when making code changes, please be extremely careful about containing / scoping your changes. Make targeted bug fixes scoped to handful of game versions and hardware configuration. When adding new features, make it off by default, unless there is a really good reason to make it the default. If you make a new default, add an option that disables it so that users can opt out as needed.
 
+#### Config file compatibility
+
+Do not change the option names used to identify them in config files, otherwise you will introduce an incompatibility with previous versions. Once the `name` is set it should never be changed. Aliases can still be added.
+
 ### Code quality requirements
 
 * Test for regressions, at least in and around the component you are modifying:

README.md

@@ -4,13 +4,15 @@
 
 # 🌶️🌶️ [https://spice2x.github.io/](https://spice2x.github.io/) 🌶️🌶️
 
+# If you have problems, read [Known Issues (FAQ)](https://github.com/spice2x/spice2x.github.io/wiki/Known-issues) wiki page first, most of your questions are already answered.
+
 <br/><br/><br/><br/><br/><br/><br/><br/>
 
 # spice2x
 
 ## Overview
 
-spice2x is a fork of SpiceTools, focused on addressing bugs, usability, and quality-of-life improvements.
+spice2x is a continuation of SpiceTools project. Original development of [SpiceTools](https://github.com/spicetools/spicetools) has stalled in 2022; spice2x is led by a new group of developers.
 
 We do not use GitHub for source control, but we do use the [issue tracker](https://github.com/spice2x/spice2x.github.io/issues) and [the wiki](https://github.com/spice2x/spice2x.github.io/wiki). Source is distributed in the release package.
 
@@ -25,14 +27,18 @@ spice2x team does not provide any tools to circumvent software copy protection,
 By policy,
 
 * we do **NOT** provide links on where to acquire game data
+* we do **NOT** provide tools or instructions on decrypting data
 * we do **NOT** provide guides on setting up & basic troubleshooting
 
 please do not ask for these, as it will never happen here.
 
 ## Submitting to the Issue Tracker
+
+**Please file bugs if you find them!** If you just complain about something in Discord servers, we can't see them, so they'll never be fixed.
+
 Rules for filing a new issue or adding comments to existing issues in the tracker:
 
-* Check the [known issues](https://github.com/spice2x/spice2x.github.io/wiki/Known-issues) page first before reporting a new issue.
+* Check the [known issues](https://github.com/spice2x/spice2x.github.io/wiki/Known-issues) page first before reporting a new issue. If you have some new information or workarounds for a known issue, you can file a documentation bug as well.
 * Use the search function and see if there is an existing issue. 
 * This is not the place to obtain a guide or receive basic troubleshooting.
 * Don't file a bug demanding game XYZ to be supported.
@@ -40,7 +46,7 @@ Rules for filing a new issue or adding comments to existing issues in the tracke
 * **Do not mention or link to external websites that distribute game data!**
 * **Do not link to external websites that provide guides on how to run games!**
 
-New GitHub accounts are prevented from creating new issues to prevent spam. Maintainers of this project reserve the right to close or delete any issues that violate the rules above, or low effort issues.
+New GitHub accounts are prevented from creating new issues to prevent spam. Maintainers of this project reserve the right to close or delete any issues that violate the rules above, or any low effort issues. If you ask for very basic troubleshooting help with setting up a game, we'll just delete them without warning.
 
 ## Contributing
 **We encourage the community to submit patches via the issue tracker for any bug fixes or feature enhancements.** If you want to resolve any reported (or not reported) bugs, implement features, add support for new games, or fix a [known issue](https://github.com/spice2x/spice2x.github.io/wiki/Known-issues) - feel free to reach out via the Issue tracker. All submitted code patches are assumed to be GPLv3 compliant.