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: create TypeDoc site? #48

Closed
jcbhmr opened this issue Jul 8, 2023 · 1 comment · Fixed by #185
Closed

Documentation: create TypeDoc site? #48

jcbhmr opened this issue Jul 8, 2023 · 1 comment · Fixed by #185
Labels
documentation Improvements or additions to documentation fund Polar.sh funding good first issue Good for newcomers

Comments

@jcbhmr
Copy link
Member

jcbhmr commented Jul 8, 2023

This is a feature request. You can close this as "Not planned" and I won't feel bad, don't worry ❤️

I think that the current setup with an examples/ folder and a bunch of docs that feel very shallow. They're also somewhat duplicated across the hover in-IDE intellisense (the .d.ts files) and the readme would be better consolidated into a single place: a documentation website. There's enough content that I think it's worth the effort (and the effort isn't much 😊)

// package.json
{
  "scripts": {
    "build:docs": "typedoc"
  },
  "typedoc": {
    "entryPoints": ["src/index.ts"]
    "out": "sitedocsdistplacefolder/name/here",
    "skipErrorChecking": true
  }
}

And then you can use GitHub Actions to deploy it to GitHub Pages in about 5 minutes of typey-types

Upvote & Fund

  • We're using Polar.sh so you can upvote and help fund this issue.
  • We receive the funding once the issue is completed & confirmed by you.
  • Thank you in advance for helping prioritize & fund our backlog.
Fund with Polar
@Aslemammad Aslemammad added the enhancement New feature or request label Apr 14, 2024
@barelyhuman
Copy link

Workaround for now: https://typeapi.barelyhuman.dev/pkg/tinybench

@jerome-benoit jerome-benoit added the good first issue Good for newcomers label Oct 20, 2024
@jerome-benoit jerome-benoit added the fund Polar.sh funding label Oct 30, 2024
@jerome-benoit jerome-benoit added documentation Improvements or additions to documentation and removed enhancement New feature or request labels Nov 7, 2024
@jerome-benoit jerome-benoit changed the title Create TypeDoc site? Documentation: create TypeDoc site? Nov 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation fund Polar.sh funding good first issue Good for newcomers
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants
@jerome-benoit @Aslemammad @barelyhuman @jcbhmr and others