Skip to content

Add migration guide for #2598 #2647

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Apr 16, 2025
Merged

Add migration guide for #2598 #2647

merged 3 commits into from
Apr 16, 2025

Conversation

cprecioso
Copy link
Member

Description

Adds a migration guide for #2598, (as started by @FranjoMindek in #2625).

Select what type of change this PR introduces:

  1. Just code/docs improvement (no functional change).
  2. Bug fix (non-breaking change which fixes an issue).
  3. New feature (non-breaking change which adds functionality).
  4. Breaking change (fix or feature that would cause existing functionality to not work as expected).

@cprecioso cprecioso added the documentation Improvements or additions to documentation label Apr 10, 2025
@cprecioso cprecioso self-assigned this Apr 10, 2025
Copy link
Contributor

@FranjoMindek FranjoMindek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we're happy with saying 0.17.X, LGTM

Copy link
Contributor

@infomiho infomiho left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • I'd go with tabs for the Before/After (to stay consistent with other migration guides).
  • Some minor text suggestions
  • Let's add this page into the sidebars.js as well

The `login` function, as imported from `wasp/client/auth`, has changed
the way of calling it:

- ❌ **OLD**: `login(usernameValue, passwordValue)`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For this kind of before/after code blocks, we usually use tabs like this: https://github.com/wasp-lang/wasp/blob/release/web/docs/migration-guides/migrate-from-0-14-to-0-15.md?plain=1#L68

### The `login` function from `wasp/client/auth` has changed parameters

:::note
Only if you are using [username and password authentication](../auth/username-and-pass.md).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence doesn't feel like a standalone sentence, I'd expand it to say smth like "This change only affects you if you are using the username & password auth. If you are using the email auth, you are fine."

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I modified it but now I feel it's a bit verbose.

Only if you are using [username and password authentication](../auth/username-and-pass.md).
:::

If you were using the `login` function (imported from `wasp/client/auth`),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd use the Before/After tabs here as well.


## What's new in 0.17.0?

### The `login` function from `wasp/client/auth` has changed parameters
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### The `login` function from `wasp/client/auth` has changed parameters
### The `login` function parameters changed (username & password only)

I have the urge to add "username & password" to the title for people that will glance over the text below. You decide if it's too much.

@cprecioso
Copy link
Member Author

@infomiho ready

Copy link
Contributor

@infomiho infomiho left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some minor suggestions, feel free to merge after you resolve them


## What's new in 0.17.0?

### The `login` function parameters changed (username & password only)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I looked at the rendered docs, this title looks less aesthetically pleasing with the (username & password only) bit. But that's just me nitpicking :D

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but then how do you want it? 😂 i roll it back to before your suggestion?

@cprecioso cprecioso merged commit 79992e9 into main Apr 16, 2025
@cprecioso cprecioso deleted the cprecioso/push-nmtzlxkotxyw branch April 16, 2025 09:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants