playdate-nim icon indicating copy to clipboard operation
playdate-nim copied to clipboard

Discrepancy between main README and currently latest version (v0.13)

Open ninovanhooff opened this issue 1 year ago • 1 comments

Problem

The example project currently will not compile when used with the bindings downloaded from Nimble. This is because multiple breaking changes have been introduced (audio player finish callback and button~s~State rename.

Reported here by user Dork: https://discord.com/channels/675983554655551509/1229190504583921694/1246518505176694898

Fix Create a new release so Nimble is up to date with main

Prevent regression To prevent this from happening again, a develop branch should be introduced. develop is only merged to main when a new release is made, so that main always represents what users will get when using requires "playdate". This then also applies for the README.md and the example project.

ninovanhooff avatar Jun 01 '24 18:06 ninovanhooff

This is something we can improve on. The intended way to view stable versions of the codebase right now is to select the version tag from the list of release tags, so that each user can inspect the code/docs for the version of the bindings they are using.

This in theory gives the most flexibility without the need for an additional branch, but it is less convenient for newcomers. So yeah, probably a dev branch is the way to go to streamline adoption during development of breaking changes.

In the meantime I'll work on releasing a new functioning package release

samdze avatar Sep 28 '24 01:09 samdze

@samdze let's go with dev then? I only prefer develop out of habit, would be fine to go with dev

ninovanhooff avatar Oct 12 '24 08:10 ninovanhooff

Yes, I'm ok with that!

samdze avatar Oct 12 '24 09:10 samdze