[Webhook] Add new component documentation

[alexandre-daubois]

Fixes #18061

ℹ️ This is an early draft for the upcoming Webhook (and RemoteEvent) component to gather early-feedback, likely to be released with 6.3.

Would be great to release the component documentation on day one!

[alexandre-daubois]

Thank you @MrYamous!

[javiereguiluz]

Alex, thanks for working on this so early! Thankfully we'll have the docs ready before the 6.3 launch.

[alexandre-daubois]

Applied your suggestions @94noni, thanks!

[norkunas]

Probably would be good to list available request parsers, because wanted to try webhook component and then needed to find out what to configure under framework.webhook.routing.*.service key

[fcvoica]

Hello @alexandre-daubois, I was looking to do something similar and I came across your PR. Is there something I can help you with?

[alexandre-daubois]

@norkunas Well it seems it is developer's responsibility to create a request parser. Maybe you were talking about mentioning \Symfony\Component\Webhook\Client\RequestParser?

@fcvoica A little review is always appreciated to improve this upcoming doc if you want! 🙂

[norkunas]

@alexandre-daubois I was talking about integrated ones like mailer.webhook.request_parser.mailgun

[fcvoica]

I'd add a small 'Configuration' section after this with a short description, and a small example:
`.. configuration-block::

.. code-block:: yaml

    # config/packages/framework.yaml
    framework:
        webhook:
            routing:
                email:
                    service: App\Webhook\MailerWebhookParser # custom parser id
                    secret: '%env(EXTERNAL_SERVICE_SECRET)%'` # this can be validated in the doPrase method

[alexandre-daubois]

I don't know if we should add this in the component documentation or in the framework documentation? 🤔

[fcvoica]

From what I've seen on other documentation pages, this is included in the component doc, not in the framework doc

[alexandre-daubois]

Added 👍

[alexandre-daubois]

Friendly ping @OskarStark @javiereguiluz, I did some updates to the page! Do you see anything to add/remove/update? 🙂

[OskarStark]

Friendly ping @fabpot

[pboschma]

Anything planned yet? Since the component released, but there is no documentation yet,

[alexandre-daubois]

It is on hold, see #18290 (comment) for the explanation 🙂

[welcoMattic]

6.4 is coming in a few weeks and we still don't have the Webhook component documentation online. Is there any blocker @javiereguiluz @alexandre-daubois?

[ToshY]

7.0 also released and the only "documentation" currently still available is this 6.3 blog post.

It is on hold, see #18290 (comment) for the explanation 🙂

Stating "discussing internally about a radically different approach" isn't an explanation for why there is still no documentation. We're already at 7.0 and there's still nothing. As a Symfony user I'm now left in the dark on how to use these new components.

If normal PRs adhere to contribution guidelines that state that documentation must be updated accordingly¹, surely this must also be true for releasing new components as well...

---

So when can we expect these documentations to be available?

Footnotes

1. https://symfony.com/doc/current/contributing/code/pull_requests.html#make-a-pull-request ↩

[OskarStark]

Closing in favor of #19249