JoshuaKGoldberg / JoshuaKGoldberg/create-typescript-app
📝 Documentation: Make a docs website
- Dominant language
- TypeScript
- Stars
- 1.4k
- Forks
- 89
- Avg merge
- 1m
- Merged PRs (30d)
- 3
Description
### Bug Report Checklist
- [X] I have pulled the latest `main` branch of the repository.
- [X] I have [searched for related issues](https://github.com/JoshuaKGoldberg/create-typescript-app/issues?q=is%3Aissue) and found none that matched my issue.
### Overview
I've been mentioning for a while now that I want to have a standalone URL website for this package. Filing this issue as something I can link to & track that with.
I'm not yet sure exactly how I want to make this. There are kind of three options, in increasing order of complexity:
1. 🍏 Standalone repo: having it be separate from this `create-typescript-app` repo
* Advantage: Easiest setup with no need to mess with this repo's tooling
* Disadvantage: Updates to the website become separate from the repo itself
2. 🍌 Inline in this repo: adding in some dependencies & scripts to generate a standalone site
* Advantages: No separation between code and docs
* Disadvantages: Added overhead of migration snapshots
3. 🍒 Converting this repo to a monorepo
* Advantages: Lets the standalone site code be more separated from the CLI code
* Disadvantages: most complicated dev setup; also blocked on #1064
I'm leaning towards 🍌 for now. But still pondering.
### Additional Info
_No response_
Contributor guide
Assessment
This issue has not been assessed yet.