Skip to content

Tutorial: Improved What's Next section#5491

Open
AllenJB wants to merge 5 commits intophp:masterfrom
AllenJB:tutorial
Open

Tutorial: Improved What's Next section#5491
AllenJB wants to merge 5 commits intophp: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?

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.

4 participants