wintermeyer / elixir-phoenix-ash

An Elixir, Phoenix and Ash Beginner's Guide
https://elixir-phoenix-ash.com
Other
10 stars 7 forks source link

Resources for updating the Phoenix guide for Version 1.7 #52

Open mardukbp opened 3 weeks ago

mardukbp commented 3 weeks ago

Phoenix 1.7 no longer has views. As a consequence, the file structure of the project changed. However, it is relatively easy to upgrade from version 1.5. This blog post shows how to do it.

In addition, the way to reference routes in a template changed. Phoenix now has compile-time verified routes, which means that the links in the ping-pong example are now of the form:

<.link href={~p"/ping"}>Ping</.link>
wintermeyer commented 3 weeks ago

Thank you for bringing this up and all the other issues too! I have to upgrade the documentation to the current versions.

It really is a big boost to get this kind of feedback. Because most people don't reach out. It is nice to see that my work helps real people.

I will tackle this issue. Just don't know when.

mardukbp commented 3 weeks ago

I followed the whole Elixir guide using the latest version, so I don't think it needs an update :) What I would suggest though is using Livebook instead of iex. It has several advantages:

Moreover, the guide itself can also be written in Livebook. It is just a Markdown file. Livebook does not currently support alerts, which are used extensively in the guide and are supported by GitHub. I already started a discussion in the Livebook repo :)

The official Ash tutorial is written in Livebook, if you want to check it out.

Thank you for writing these awesome guides!

wintermeyer commented 3 weeks ago

I followed the whole Elixir guide using the latest version, so I don't think it needs an update :)

Thank you for this input! That helps me a lot and saves time.

What I would suggest though is using Livebook instead of iex.

I am not a big fan about LiveBook. I do not know why exactly. But I want the reader to interact with an iex. To be able to fire up a real iex -S mix phx.server and to interact with that via a browser. To play around with it.

To this day I haven't found a LiveBook documentation which hooked me. But I am an IT dinosaur. Maybe I just don't want to learn a new trick. ;-)

Thank you for writing these awesome guides!

Thank YOU for taking the time to help me with your feedback! You have no idea how much joy that brings me to see that my work helps other people to learn Elixir, Phoenix and Ash. Most people don't take the time to give me feedback and I don't blame them.

Thank you!