phoenixframework / phoenix_live_view

Rich, real-time user experiences with server-rendered HTML
https://hex.pm/packages/phoenix_live_view
MIT License
6k stars 906 forks source link

Sidebar guides in progressive order #3252

Open rhcarvalho opened 2 months ago

rhcarvalho commented 2 months ago

Environment

Actual behavior

When I consult the documentation (which is btw top quality :purple_heart: ), I expected the guides to be ordered based on a progression from basic to more advanced topics that might make more sense for someone new to Phoenix LiveView.

Expected behavior

I'd be willing to give this a shot / send a PR if welcome. One possible direction:

SERVER-SIDE FEATURES

Current order Suggestion
Assigns and HEEx templates Assigns and HEEx templates
Deployments Live layouts
Error and exception handling Live navigation
Live layouts Error and exception handling
Live navigation Security considerations
Security considerations Telemetry
Telemetry Deployments
Uploads Uploads
Gettext for internationalization Gettext for internationalization

CLIENT-SIDE INTEGRATION

(no changes)

| Current order | Suggestion | |-----------------------------|-----------------------------| | Bindings | Bindings | | Form bindings | Form bindings | | JavaScript interoperability | JavaScript interoperability | | External Uploads | External Uploads |