Skip to content

Conversation

@ThomasLandauer
Copy link
Member

@ThomasLandauer ThomasLandauer commented Mar 15, 2021

I shortened the example, cause $emails[0]->getTo()[0]; looks strange ;-) Instead, I added the "See also"-links which (I think) are a good idea in general since the page gets longer and longer, so it's harder to get an overview what functions do exist at all...

The @var annotation syntax is taken from https://phpstan.org/writing-php-code/phpdoc-types#general-arrays - I'm not 100% sure if this is the right way.

The closing */ in my new @var line now breaks the code completely ;-) (same as in #119) - is there a way to escape this?

I shortened the example, cause `$emails[0]->getTo()[0];` looks strange ;-) Instead, I added the "See also"-links which (I think) are a good idea in general since the page gets longer and longer, so it's harder to get an overview what functions do exist at all...

The `@var` annotation syntax is taken from https://phpstan.org/writing-php-code/phpdoc-types#general-arrays - I'm not 100% sure if this is the right way.

The closing `*/` in my new `@var` line might break the page rendering completely ;-) (same as in Codeception#119) - is there a way to escape this?
*
* ```php
* <?php
* /** @var array<int, \Symfony\Component\Mime\Email> $emails */
Copy link
Member

Choose a reason for hiding this comment

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

Please remove this @var annotation, you can't */ in the middle of a docblock

Copy link
Member Author

Choose a reason for hiding this comment

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

But I like the idea - it makes the code sample so nicely copy-pastable :-)
I now tried to escape it - according to https://stackoverflow.com/a/1439351/1668200
Let's see how this comes out - otherwise I'll change it back...

@TavoNiievez TavoNiievez self-requested a review March 15, 2021 16:40
@TavoNiievez
Copy link
Member

@ThomasLandauer please resolve conflicts.

@ThomasLandauer
Copy link
Member Author

I started from scratch ;-)

ThomasLandauer added a commit to ThomasLandauer/module-symfony that referenced this pull request Mar 16, 2021
`example.com` is the "official" domain for such things: http://example.com/

For the removal, see Codeception#120 (comment)
@ThomasLandauer ThomasLandauer deleted the patch-6 branch September 27, 2021 22:50
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

Successfully merging this pull request may close these issues.

2 participants