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

Document Type information for Custom Events #145

Merged
merged 1 commit into from
Feb 13, 2024

Conversation

seanpdoyle
Copy link
Contributor

It appears that the team's official stance is that documentation for the package's Custom Events should reside on a consumer-facing website.

The documentation for Custom Events already exists, but doesn't provide particulars for the shapes of the most of the event.details objects.

This commit brings more structure to the page, namely:

  • groups events by their source
  • promotes event names to deeply-linkable headings
  • adds HTML tables to describe each event's event.detail properties, along with type information

@seanpdoyle
Copy link
Contributor Author

@afcapel @jorgemanrubia I've updated this branch to incorporate the new events described by #159.

Copy link
Member

@jorgemanrubia jorgemanrubia left a comment

Choose a reason for hiding this comment

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

@afcapel ok to merge this one? I'd like to reference from #160, as suggested by @seanpdoyle.

It appears that the team's [official stance][] is that documentation for
the package's Custom Events should reside on a consumer-facing website.

The documentation for Custom Events already exists, but doesn't provide
particulars for the shapes of the most of the `event.details` objects.

This commit brings more structure to the page, namely:

* groups events by their source
* promotes event names to deeply-linkable headings
* adds HTML tables to describe each event's `event.detail` properties,
  along with type information

[official stance]: hotwired/turbo#984 (comment)
@seanpdoyle
Copy link
Contributor Author

seanpdoyle commented Feb 13, 2024

@jorgemanrubia this is ready for re-review.

@jorgemanrubia jorgemanrubia merged commit a1021f1 into hotwired:main Feb 13, 2024
@seanpdoyle seanpdoyle deleted the event-types branch February 13, 2024 16:37
seanpdoyle added a commit to seanpdoyle/turbo-site that referenced this pull request Feb 13, 2024
Follow-up to [hotwired#145][]

Escape a `|` operator to avoid Markdown's confusion about whether or not
its a cell separator to a character.

[hotwired#145]: hotwired#145
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

3 participants