JoshuaKGoldberg / JoshuaKGoldberg/create-typescript-app

📝 Documentation: Make a docs website

Open
#1,193 2 comments 0 reactions 1 assignee Claimed by @JoshuaKGoldberg View on GitHub
area: documentation status: blocked type: feature
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.