Group XSLT docs into Guides and Reference #37825

pepelsbey · 2025-01-27T13:14:46Z

Moves pages into guides and reference folders

- web/xslt/element
+ web/xslt/reference/element
- web/xslt/common_errors
+ web/xslt/guides/common_errors
etc.

Creates landing pages for guides and references

+ web/xslt/reference/index.md
+ web/xslt/guides/index.md

Uses front-matter sidebar

+ sidebar: xsltsidebar
- {{XsltSidebar}}

Cleans up guides and landings

Removes duplicated info
Removes handmade breadcrumbs

Uses new page type

+ page-type: listing-page

Motivation

Docs IA & maintenance

TODO

Check links in BCD
Fix links in web-features

github-actions · 2025-01-27T13:16:17Z

Preview URLs (90 pages)

Flaws (5)

Note! 87 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/XSLT/Reference/Element/stylesheet
Title: <xsl:stylesheet>
Flaw count: 1

broken_links:
- Can't resolve /en-US/docs/Web/XSLT/Element/for-each-group

URL: /en-US/docs/Web/EXSLT/math/min
Title: math:min()
Flaw count: 2

broken_links:
- /en-US/docs/Web/XSLT/Transforming_XML_with_XSLT is a redirect
- /en-US/docs/Web/XSLT/Element is a redirect

URL: /en-US/docs/Web/EXSLT/math/max
Title: math:max()
Flaw count: 2

broken_links:
- /en-US/docs/Web/XSLT/Transforming_XML_with_XSLT is a redirect
- /en-US/docs/Web/XSLT/Element is a redirect

External URLs (3)

URL: /en-US/docs/Web/XSLT
Title: XSLT: Extensible Stylesheet Language Transformations

https://www.w3schools.com/xml/xsl_intro.asp (1 time) (Note! This may be a new URL 👀)
https://www.xml.com/pub/a/2000/08/holman/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/XPath/Axes
Title: Axes

https://www.w3.org/TR/xpath-30/ (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-01-31 14:02:01)

bsmth

Could you please update the xsltsidebar like this?

-    path: /Web/XSLT/Transforming_XML_with_XSLT
+    path: /Web/XSLT/Guides/Transforming_XML_with_XSLT
   - type: section
-    link: /Web/XSLT/Element
+    link: /Web/XSLT/Reference/Element
   - type: listSubPages
-    path: /Web/XSLT/Element
+    path: /Web/XSLT/Reference/Element

files/en-us/web/xslt/index.md

files/en-us/web/xslt/reference/element/index.md

files/en-us/web/xslt/index.md

wbamberg · 2025-01-28T20:13:00Z

files/en-us/web/xslt/guides/index.md

+title: XSLT guides
+short-title: Guides
+slug: Web/XSLT/Guides
+page-type: listing-page


How is this different to landing-page, which is described as:

a page that acts primarily as a navigation aid, listing links to other pages.

? Also, adding new page types is a pretty significant change, it would be nice if there could be a discussion involving all maintainers when new page types are proposed.

We’re still experimenting with a handful of sections to iron out the workflow and needed changes.

We’ll update the description of the generic page types to differentiate landings from listings.

files/en-us/web/xslt/reference/element/element/index.md

files/en-us/web/xslt/reference/element/fallback/index.md

files/en-us/web/xslt/reference/element/for-each/index.md

files/en-us/web/xslt/reference/element/if/index.md

files/en-us/web/xslt/reference/element/import/index.md

files/en-us/web/xslt/reference/element/value-of/index.md

files/en-us/web/xslt/reference/element/variable/index.md

files/en-us/web/xslt/reference/element/when/index.md

files/en-us/web/xslt/reference/element/with-param/index.md

files/en-us/web/xslt/reference/index.md

Changes applied

bsmth · 2025-01-31T12:18:29Z

files/en-us/web/xslt/reference/element/index.md

+
+The element annotations that follow include a description, a syntax listing, a list of required and optional attributes, a description of type and position, its source in the W3C Recommendation and an explanation of the degree of present Gecko support.
+
+- [`<xsl:apply-imports>`](/en-US/docs/Web/XSLT/Reference/Element/apply-imports)


I guess you can do {{ListSubpages}} but we'd miss the inline support info

bsmth · 2025-01-31T12:21:45Z

I think to double-check sidebar: xsltsidebar v macro and if front-matter defined:

sidebar: xsltsidebar v

sidebar: 
  - xsltsidebar

Both are currently allowed.

Everything else gets a +1 from me 👍🏻

bsmth

Approving with non-blocking comments 👍🏻

pepelsbey added 3 commits January 23, 2025 13:08

Move references

39c76a1

Move guides

4decb94

Clean up listing pages

97f202e

pepelsbey requested a review from bsmth January 27, 2025 13:14

pepelsbey requested review from a team as code owners January 27, 2025 13:14

github-actions bot added Content:Other Any docs not covered by another "Content:" label Content:Meta Content in the meta docs system [PR only] Infrastructure and configuration for the project size/m [PR only] 51-500 LoC changed labels Jan 27, 2025

bsmth previously requested changes Jan 27, 2025

View reviewed changes

bsmth reviewed Jan 27, 2025

View reviewed changes

files/en-us/web/xslt/index.md Show resolved Hide resolved

bsmth reviewed Jan 27, 2025

View reviewed changes

files/en-us/web/xslt/reference/element/index.md Show resolved Hide resolved

bsmth reviewed Jan 27, 2025

View reviewed changes

files/en-us/web/xslt/index.md Outdated Show resolved Hide resolved

pepelsbey force-pushed the move/xslt branch from 1f1abc8 to 97f202e Compare January 28, 2025 14:50

wbamberg reviewed Jan 28, 2025

View reviewed changes

pepelsbey and others added 3 commits January 29, 2025 13:40

Apply code review suggestions

bb2a84a

Merge branch 'main' into move/xslt

d4b212e

Use front matter sidebar

15f3a6d

github-actions bot added size/l [PR only] 501-1000 LoC changed and removed size/m [PR only] 51-500 LoC changed labels Jan 30, 2025

This comment was marked as outdated.

Sign in to view

Remove local listing-page type

bbe6599

github-actions bot removed the system [PR only] Infrastructure and configuration for the project label Jan 30, 2025

This comment was marked as outdated.

Sign in to view

Use manual reference description

df571b6

github-actions bot reviewed Jan 30, 2025

View reviewed changes

pepelsbey and others added 2 commits January 30, 2025 14:03

Merge branch 'main' into move/xslt

f4ccdd8

Merge branch 'main' into move/xslt

e52741f

bsmth reviewed Jan 31, 2025

View reviewed changes

pepelsbey changed the title ~~Group XSLT docs into guides and references~~ Group XSLT docs into Guides and Reference Jan 31, 2025

Merge branch 'main' into move/xslt

05bd108

bsmth approved these changes Jan 31, 2025

View reviewed changes

Rumyra approved these changes Jan 31, 2025

View reviewed changes

Rumyra merged commit 968a812 into mdn:main Jan 31, 2025
9 checks passed

pepelsbey deleted the move/xslt branch January 31, 2025 14:17

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Group XSLT docs into Guides and Reference #37825

Group XSLT docs into Guides and Reference #37825

pepelsbey commented Jan 27, 2025 •

edited

Loading

github-actions bot commented Jan 27, 2025 •

edited

Loading

bsmth left a comment

wbamberg Jan 28, 2025

pepelsbey Jan 30, 2025

This comment was marked as outdated.

This comment was marked as outdated.

bsmth Jan 31, 2025

bsmth commented Jan 31, 2025

bsmth left a comment


		The element annotations that follow include a description, a syntax listing, a list of required and optional attributes, a description of type and position, its source in the W3C Recommendation and an explanation of the degree of present Gecko support.

		- [`<xsl:apply-imports>`](/en-US/docs/Web/XSLT/Reference/Element/apply-imports)

Group XSLT docs into Guides and Reference #37825

Group XSLT docs into Guides and Reference #37825

Conversation

pepelsbey commented Jan 27, 2025 • edited Loading

Moves pages into guides and reference folders

Creates landing pages for guides and references

Uses front-matter sidebar

Cleans up guides and landings

Uses new page type

Motivation

TODO

github-actions bot commented Jan 27, 2025 • edited Loading

bsmth left a comment

Choose a reason for hiding this comment

wbamberg Jan 28, 2025

Choose a reason for hiding this comment

pepelsbey Jan 30, 2025

Choose a reason for hiding this comment

This comment was marked as outdated.

This comment was marked as outdated.

bsmth Jan 31, 2025

Choose a reason for hiding this comment

bsmth commented Jan 31, 2025

bsmth left a comment

Choose a reason for hiding this comment

pepelsbey commented Jan 27, 2025 •

edited

Loading

github-actions bot commented Jan 27, 2025 •

edited

Loading