Skip to content

starlight docs#748

Merged
pelikhan merged 7 commits intomainfrom
pelikhan/astro
Sep 12, 2025
Merged

starlight docs#748
pelikhan merged 7 commits intomainfrom
pelikhan/astro

Conversation

@pelikhan
Copy link
Contributor

@pelikhan pelikhan commented Sep 11, 2025

Migrating docs to starlight.

  • scafold starlight project
  • move markdown
  • add frontmatter
  • updated index.md
  • update readme to be AI friendly

@pelikhan
Copy link
Contributor Author

@copilot update markdown files in docs/src/content/docs/reference/frontmatter.md with a correct frontmatter for starlight. Minimum title and description. Infer title and description from each page content.

https://starlight.astro.build/reference/frontmatter/

Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #749, to work on those changes. Once the pull request is ready, I'll request review from you.

@pelikhan
Copy link
Contributor Author

@copilot update docs/src/content/docs/index.mdx for the current project (review readme.md, concepts and the documentation) for inspiration.

Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #750, to work on those changes. Once the pull request is ready, I'll request review from you.

…ocs (#749)

* Initial plan

* Add Starlight frontmatter to all reference documentation files

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan
Copy link
Contributor Author

@copilot add github action workflow (docs.yml) that runs on workflow_dispatch or release: created. build the astro docs, uploads to github pages using artifacts.

Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #751, to work on those changes. Once the pull request is ready, I'll request review from you.

@pelikhan
Copy link
Contributor Author

@copilot repair the links in the README.md file since .md files have been moved.

Copilot AI mentioned this pull request Sep 11, 2025
6 tasks
Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #752, to work on those changes. Once the pull request is ready, I'll request review from you.

@pelikhan
Copy link
Contributor Author

@copilot follow astro best practices ( https://starlight.astro.build/guides/authoring-content/ ) with the markdown files in docs/src/content/docs/*.md

Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #753, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot AI and others added 2 commits September 11, 2025 16:55
* Initial plan

* Update docs for GitHub Agentic Workflows and add docs deployment workflow

- Updated index.mdx to properly represent GitHub Agentic Workflows project
- Added GitHub Actions workflow for building and deploying docs to GitHub Pages
- Verified all reference docs already have proper Starlight frontmatter

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
* Initial plan

* Fix broken documentation links in README.md after Starlight migration

Update all docs links to point to new Starlight structure:
- docs/quick-start.md → docs/src/content/docs/reference/quick-start.md
- docs/concepts.md → docs/src/content/docs/reference/concepts.md
- docs/samples.md → docs/src/content/docs/reference/samples.md
- docs/index.md → docs/src/content/docs/index.mdx

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: Peli de Halleux <pelikhan@users.noreply.github.com>
@pelikhan
Copy link
Contributor Author

@copilot update the docs/src/contents/docs markdown file and remove the level 1 header since it is already in the frontmatter and rendered by astro.

Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #754, to work on those changes. Once the pull request is ready, I'll request review from you.

with:
path: ./docs/dist

deploy:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

only deploy if the event is workflow_dispatch or release

name: Deploy Documentation to GitHub Pages

on:
workflow_dispatch:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@copilot also trigger on push with paths docs/**

# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
concurrency:
group: "pages"
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@copilot add ref in group identifier

@pelikhan pelikhan changed the title barebone starlight docs starlight docs Sep 11, 2025
@pelikhan
Copy link
Contributor Author

@copilot apply review comments

Copy link
Contributor

Copilot AI commented Sep 11, 2025

@pelikhan I've opened a new pull request, #755, to work on those changes. Once the pull request is ready, I'll request review from you.

@pelikhan pelikhan merged commit cf16332 into main Sep 12, 2025
9 checks passed
@pelikhan pelikhan deleted the pelikhan/astro branch September 12, 2025 00:32
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.

2 participants