Skip to content

chore(docs): move partials files for Astro/Starlight#649

Merged
melissahenderson merged 6 commits intomainfrom
mh-partials
Mar 19, 2026
Merged

chore(docs): move partials files for Astro/Starlight#649
melissahenderson merged 6 commits intomainfrom
mh-partials

Conversation

@melissahenderson
Copy link
Collaborator

@melissahenderson melissahenderson commented Mar 19, 2026

This issue partly resolves the tech writers' DOC-24 Linear issue

Previously, the partials subfolder was outside of the docs subfolder. Astro/Starlight made a change where asides used in partials would no longer render if the partials files were outside of the docs folder.

This issue moves the partials so that we don't have issues in the future.

This issue partly resolves the tech writers' DOC-24 Linear issue
@netlify
Copy link

netlify bot commented Mar 19, 2026

Deploy Preview for webmonetization-preview ready!

Name Link
🔨 Latest commit a7b7514
🔍 Latest deploy log https://app.netlify.com/projects/webmonetization-preview/deploys/69bc0ef7785d470008fcaa20
😎 Deploy Preview https://deploy-preview-649--webmonetization-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@w3cbot
Copy link

w3cbot commented Mar 19, 2026

melissahenderson marked as non substantive for IPR from ash-nazg.

Copy link
Collaborator

@sidvishnoi sidvishnoi left a comment

Choose a reason for hiding this comment

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

I'll investigate if we can do without title frontmatter - that seems useless from a partial's point and extra work.

import HowRel from '/src/partials/link-element-how-rel.mdx'
import HowAgent from '/src/partials/link-element-how-agent.mdx'
import ContPayments from '/src/partials/link-element-cont-payments.mdx'
import Overview from '/src/content/docs/partials/link-element-overview.mdx'
Copy link
Collaborator

Choose a reason for hiding this comment

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

Would it be helpful to add an alias to partials dir? Then we can have imports like:

import Overview from '#partials/link-element-overview.mdx'

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Could we set something like that up later? I need to do the same thing with Rafiki, Open Payments, and maybe another I'm forgetting at the moment.

@sidvishnoi sidvishnoi changed the title Moving partials files chore(docs): move partials files for Astro/Starlight Mar 19, 2026
@sidvishnoi
Copy link
Collaborator

sidvishnoi commented Mar 19, 2026

I'll investigate if we can do without title frontmatter - that seems useless from a partial's point and extra work. (#649 (review))

If we rename the partials file to start with _ (e.g. ./partials/_link-element-overview.mdx), we can let go of title in frontmatter.
Please do confirm it still resolves the original issue.

@melissahenderson melissahenderson merged commit 2ac5af5 into main Mar 19, 2026
7 checks passed
@melissahenderson melissahenderson deleted the mh-partials branch March 19, 2026 15:30
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.

3 participants