C64MEGA65 icon indicating copy to clipboard operation
C64MEGA65 copied to clipboard

Documentation TODOs for Release 5.1

Open sy2002 opened this issue 5 months ago • 0 comments

R5/R6 cartridge challenges / CORE 0 update

The release version of CORE #0 that will be shipped with the 2024 models will still have challenges when it comes to cartridge detection as described here: https://github.com/MEGA65/mega65-core/issues/781

Depending on the status we need to adjust README.md to point people to solutions (such as waiting for a newer CORE #0 version or maybe the is already 0.97 available and then we point them to installation instructions)

After develop has been merged to master

  • Correct links in doc/FAQ.md, doc/RTC.md
  • Make sure the links in bin are correct, specifically also in bin/.../README.md
  • Sift through (grep) documentations for links that link to develop

models.md

  • Double-check and make consistent with zxuno
  • Double-check .bit and .cor naming conventions (also in bin/README)

General

✅ Scan for mentions of "Version 5" in README.md, FAQ.md, cartridge.md and others and replace by "Version 5.1"

  • Update VERSIONS.md (date)
  • Make release in GitHub using the VERSIONS.md entry
  • Make sure the master and develop branch are in sync

FAQ

  • re KCS and long reset - or more general - Do not use LONG reset for any hardware cartridge. Instead always use the short reset: This is by design: We are masking the "CBM80" signature on long reset. In the previous core version V5 (the currently officially released version) there was a long reset bug that lead to long reset not working (for example you could not leave Uridium or Eagles Nest). Now in the up-and-coming V5.1 version, long reset is fixed that means each cartridge that relies on the CBM80 signature will not work properly on long reset. Not all cartridges rely on this signature.(Here is more info on the signature: http://tech.guitarsite.de/cbm80.html and here is how we implemented LONG reset: https://www.c64-wiki.de/wiki/Reset-Taster )

  • Cartridge topic: https://discord.com/channels/719326990221574164/794775503818588200/1222651625475149834

sy2002 avatar Jan 15 '24 13:01 sy2002