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

Extensions documentation could make need for hx-ext clearer #2475

Open
ChrisJefferson opened this issue Apr 9, 2024 · 3 comments
Open

Extensions documentation could make need for hx-ext clearer #2475

ChrisJefferson opened this issue Apr 9, 2024 · 3 comments

Comments

@ChrisJefferson
Copy link
Contributor

ChrisJefferson commented Apr 9, 2024

Via google I landed on the manual page for 'response-targets', which did exactly what I want.

For a while I couldn't get it to work, because I'd never used an extension before, and didn't carefully every bit, so I didn't understand how important hx-ext was.

How about, under "install" in each extension, after the "Install" line, adding a line that says something like:

All extensions must be [enabled](@/extensions/_index.md) using [hx-ext](@/attributes/hx-ext.md) before that can be used.

Just to point people towards this important thing they must read (I'm linking to both extensions, and ht-ext, as those are I think the two most useful pages?)

I'm happy to make a PR, just wanted to check what people thought before I bothered going through all the extension pages.

@glossd
Copy link

glossd commented Oct 18, 2024

It would be great if response-targets was part of the main htmx library. It's the only way to error handle HTTP requests, which I think should be done with every request.
But anyway, I forgot I need that hx-ext tag attribute as well.

@Telroshan
Copy link
Collaborator

Forgot to answer back then @ChrisJefferson , but sure feel free to open a documentation improvement PR!

@marisst
Copy link
Contributor

marisst commented Dec 19, 2024

@ChrisJefferson and @glossd, I have created a PR significantly elaborating the instructions of setting up HTMX extensions. Based on your inputs, I have made the importance of enabling the extensions with the hx-ext tag more visible and repeated it multiple times.

The PR: #3078

Skjermbilde 2024-12-19 kl  22 02 53 image

Similar communication is used in the dedicate pages of the core extensions.

I hope you like it and we can close this issue after the PR is merged.

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

4 participants