Skip to content

Tutorial: Improved What's Next section#5491

Merged
jordikroon merged 6 commits into
php:masterfrom
AllenJB:tutorial
May 9, 2026
Merged

Tutorial: Improved What's Next section#5491
jordikroon merged 6 commits into
php:masterfrom
AllenJB:tutorial

Conversation

@AllenJB
Copy link
Copy Markdown
Contributor

@AllenJB AllenJB commented Apr 14, 2026

I present a revised "What's Next?" tutorial section, with the aim of better pointing new users towards the manual sections for specific things they may want to achieve, and the range of resources available in the PHP ecosystem more generally.

I am aware the external links need to be pulled out to doc-base, but wanted to get initial feedback before I do that.

All feedback welcome.

Comment thread chapters/tutorial.xml Outdated
Copy link
Copy Markdown
Member

@TimWolla TimWolla left a comment

Choose a reason for hiding this comment

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

I think this is a good improvement overall.

Comment thread chapters/tutorial.xml Outdated
Comment thread chapters/tutorial.xml Outdated
@TimWolla TimWolla requested a review from Girgias April 17, 2026 18:02
Copy link
Copy Markdown
Member

@Girgias Girgias left a comment

Choose a reason for hiding this comment

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

LGTM, outside of Tim's comment about using <simpara> where possible (as it gets rendered to a standard HTML <p> tag rather than a <div>

Comment thread chapters/tutorial.xml
Comment on lines +446 to +449
<simpara>
For a variety of podcasts, presentations and other videos, check out the
<link xlink:href="&url.phpctv;">community PeerTube</link>.
</simpara>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Seeing this one being the source of the build failure: This might require some discussion on Internals whether it's acceptable to specifically call out this instance (over any other or YouTube).

If you drop this paragraph, I'm happy to merge.

Copy link
Copy Markdown
Contributor Author

@AllenJB AllenJB Apr 19, 2026

Choose a reason for hiding this comment

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

I would like to keep this if possible, I think it's a useful resource.

With regards to YouTube, I don't know of any way to reliably link to a variety of up-to-date PHP community content in the same way phpc.tv allows here.

Based on socials (phpc.tv's and Anna Filina's mastodon posts) and information on phpc.tv itself, anyone can submit their existing channel content to be sync'd but accounts are moderated. Subsequently I believe the likelihood of phpc.tv showing users undesirable content is low.

Mailing list discussion: https://news-web.php.net/php.internals/130668

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would like to keep this if possible, I think it's a useful resource.

Depending on the results of the discussion, we can add it back it later and get the other improvements shipped already?

Comment thread chapters/tutorial.xml Outdated
Comment thread chapters/tutorial.xml Outdated
Co-authored-by: Louis-Arnaud <la.catoire@gmail.com>
Girgias pushed a commit to php/doc-base that referenced this pull request Apr 29, 2026
@AllenJB
Copy link
Copy Markdown
Contributor Author

AllenJB commented May 4, 2026

It's now been 2 weeks since I posted on internals and there's been no messages against and 1 in support of the inclusion of phpc.tv

The doc-base PR has also been merged.

As far as I'm aware there's no outstanding issues on this PR

@jordikroon
Copy link
Copy Markdown
Member

As there haven't been any objections regarding the new external resource over the mailing list. This is good to go.
Thank you for checking, and if desired we can always make alterations on this matter.

@jordikroon jordikroon merged commit 1340d35 into php:master May 9, 2026
2 of 3 checks passed
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.

6 participants