Skip to content
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.

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

Documentation: Automated Component Documentation #2928

Merged
merged 29 commits into from
Nov 8, 2024

Conversation

Hugos68
Copy link
Contributor

@Hugos68 Hugos68 commented Nov 4, 2024

Linked Issue

Closes #2399

Description

Generates JSON documentation files from types.ts files and consumes these in the next.skeleton.dev website.

Additions:

  • Added scripts/generate-component-docs.ts file used to generate component docs.
  • Added typelens private package for generating documentation from types.ts files.
  • Cleaned up some scripts all over the project as many were redundant and/or doing the same thing

Changsets

Instructions: Changesets automate our changelog. If you modify files in /packages, run pnpm changeset in the root of the monorepo, follow the prompts, then commit the markdown file. Changes that add features should be minor while chores and bugfixes should be patch. Please prefix the changeset message with feat:, bugfix: or chore:.

Checklist

Please read and apply all contribution requirements.

  • This PR targets the next branch (NEVER master)
  • Documentation reflects all relevant changes
  • Branch is prefixed with: docs/, feat/, chore/, bugfix/
  • Ensure Svelte and Typescript linting is current - run pnpm ci:check
  • Ensure Prettier linting is current - run pnpm format
  • All test cases are passing - run pnpm test
  • Includes a changeset (if relevant; see above)

Copy link

changeset-bot bot commented Nov 4, 2024

🦋 Changeset detected

Latest commit: 6167fad

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copy link

vercel bot commented Nov 4, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
skeleton-docs ❌ Failed (Inspect) Nov 8, 2024 11:19pm
1 Skipped Deployment
Name Status Preview Comments Updated (UTC)
skeleton-themes ⬜️ Ignored (Inspect) Visit Preview Nov 8, 2024 11:19pm

Copy link

vercel bot commented Nov 4, 2024

@Hugos68 is attempting to deploy a commit to the Skeleton Labs Team on Vercel.

A member of the Team first needs to authorize it.

@Hugos68 Hugos68 changed the title component docs are now generated Documentation: Automated Component Documentation Nov 4, 2024
@Hugos68
Copy link
Contributor Author

Hugos68 commented Nov 5, 2024

@endigo9740 For the vercel build to pass we need to run pnpm build:docs from the root of the monorepo from now on. The output will be ./sites/next.skeleton.dev/dist relative to the root (in case Vercel requires you to specify).

@endigo9740 endigo9740 merged commit de4631f into skeletonlabs:next Nov 8, 2024
5 of 7 checks passed
@endigo9740 endigo9740 mentioned this pull request Nov 8, 2024
12 tasks
@Hugos68 Hugos68 deleted the feat/api-docs branch November 8, 2024 23:33
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