Skip to content
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

Documentation on integrating a form into a View #1958

Open
liammcdermott opened this issue May 3, 2024 · 0 comments
Open

Documentation on integrating a form into a View #1958

liammcdermott opened this issue May 3, 2024 · 0 comments

Comments

@liammcdermott
Copy link
Contributor

Problem

The documentation on forms is great, it makes building forms easy. However, when the user has written a form function, there doesn't seem to be anything in the docs describing how to integrate it into a View. In particular, I was confused by where post comes from in the form function parameters.

The documentation is also unclear on what happens when a form is submitted, and how to handle its life cycle in general.

Solution

Add to the forms section of the documentation: describe how to integrate a form into the greater application, and how to manage its life cycle.

I see the forms documentation has a section on Validation, but it's unclear on where that code should go in the application. The examples feel a bit unmoored from their context.

It is likely that I've skipped over some previous section that explained all this architecture. Which could be used as a reason to close this, but I doubt I'm the only one skipping around to the bits I'm interested in 😄 . If the documentation already exists, the form section should include a link to it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant