documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Add "Related content" as the final section in most pages

Open stevepiercy opened this issue 4 months ago • 4 comments

As an example, the MS SQL docs have "Related content" as the final section in most of their pages.

Screenshot 2025-09-22 at 12 49 15 AM

https://learn.microsoft.com/en-us/sql/t-sql/queries/at-time-zone-transact-sql?view=sql-server-ver17#related-content

I think something like this would be a nice enhancement for the future docs structure.

Originally posted by @stevepiercy in https://github.com/plone/volto/pull/7360#discussion_r2367018720

stevepiercy avatar Sep 22 '25 11:09 stevepiercy

This issue is really vague, I think it can be broken down

Manas-Kenge avatar Nov 25 '25 14:11 Manas-Kenge

That comment is pretty vague. If you can improve the description to be less vague, then please do so.

I don't think it's necessary to say, for example, "On Page X, add section 'Related content' with links to Page 1, Page 2, Page 3. On Page Y, add section 'Related content' with links to Page 4, Page 5, Page 6." That's busy work.

stevepiercy avatar Nov 25 '25 19:11 stevepiercy

That comment is pretty vague. If you can improve the description to be less vague, then please do so.

I don't think it's necessary to say, for example, "On Page X, add section 'Related content' with links to Page 1, Page 2, Page 3. On Page Y, add section 'Related content' with links to Page 4, Page 5, Page 6." That's busy work.

I understand what you mean but I didn’t mean to suggest specifying every single page. I only meant that the current issue feels quite broad, and breaking it into a few scoped sub-issues (e.g., Volto UI, Classic UI, REST API, etc.) might make it easier to discuss and implement. This could help reduce the overall scope while keeping the work manageable.

Manas-Kenge avatar Nov 26 '25 14:11 Manas-Kenge

I'm fine with incremental change. One page at a time, where relevant, is good. I don't expect it all to be added everywhere in one fell swoop, and I certainly wouldn't want to review such a humongous beast all at once either.

stevepiercy avatar Nov 26 '25 19:11 stevepiercy

Hi! I'm Roshani, I'm new to Plone and would love to contribute to this issue. I plan to start small by adding a "Related content" section to one or two suitable documentation pages, following the guidelines mentioned above. Please let me know if that sounds good.

Roshani-97 avatar Jan 05 '26 20:01 Roshani-97

@Roshani-97 please read and follow First-time contributors, especially Things not to do, Contributing to Plone, and Contribute to documentation.

stevepiercy avatar Jan 06 '26 04:01 stevepiercy