Skip to content

feat: serve pages as markdown and update llms.txt (#2249) #2289

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kaankacar wants to merge 4 commits into
base: main
Choose a base branch
from
Open

feat: serve pages as markdown and update llms.txt (#2249) #2289

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
2aa85ed
feat: serve pages as markdown and update llms.txt (#2249)
kaankacar Mar 2, 2026
b351733
scope nginx .md rule to /docs/ and update llms.txt URLs to .md
kaankacar Mar 3, 2026
21f9176
add spacing above and below markdown actions button
kaankacar Mar 3, 2026
6bde15a
fix markdown actions button spacing
kaankacar Mar 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docusaurus.config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,7 @@ const config: Config = {
],
'./src/plugins/route-export/index.ts',
'./src/plugins/analytics-module/index.ts',
'docusaurus-markdown-source-plugin',
],
markdown: {
mermaid: true,
Expand Down
7 changes: 7 additions & 0 deletions nginx/nginx.conf
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,5 +33,12 @@ http {
location /404.html {
add_header 'Cache-Control' 'no-store' always;
}
location ~* ^(/docs/.+)\.md$ {
resolver 1.1.1.1 valid=300s;
Copy link

Copilot AI Mar 2, 2026

Choose a reason for hiding this comment

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

resolver 1.1.1.1 hard-codes a public DNS resolver. This can break in restricted networks and may violate infra/security expectations; prefer using the environment's DNS (or a configurable internal resolver) and consider defining it at the http {} level to keep resolver policy centralized.

Suggested change
resolver 1.1.1.1 valid=300s;

Copilot uses AI. Check for mistakes.
Copy link
Collaborator Author

@kaankacar kaankacar Mar 4, 2026

Choose a reason for hiding this comment

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

Resolver is required here, nginx won't resolve the hostname in proxy_pass without an explicit resolver directive. Removing it would break the proxy entirely. 1.1.1.1 is intentional for this public-facing deployment is what i see. @ElliotFriend thoughts?

proxy_pass https://developers.stellar.org$1;
proxy_set_header Accept "text/markdown";
proxy_set_header Host "developers.stellar.org";
proxy_ssl_server_name on;
}
}
}
1 change: 1 addition & 0 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@
"@stellar/open-rpc-docs-react": "^0.2.1",
"ajv": "^8.18.0",
"clsx": "^2.1.1",
"docusaurus-markdown-source-plugin": "^2.0.1",
"docusaurus-plugin-openapi-docs": "4.5.1",
"docusaurus-plugin-sass": "^0.2.6",
"docusaurus-plugin-sentry": "^2.1.0",
Expand Down
4 changes: 4 additions & 0 deletions src/css/custom.scss
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -241,3 +241,7 @@ select[data-testid="example-pairing-select"] {
line-height: 1;
display: inline-block;
}

.markdown-actions-container {
margin-bottom: calc(1.25 * var(--ifm-leading));
}
Loading