Skip to content

Commit 15ed238

Browse files
committed
v0.0.1
1 parent f8cfa57 commit 15ed238

File tree

4 files changed

+64
-6
lines changed

4 files changed

+64
-6
lines changed

.github/workflows/release.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ jobs:
4343
yarn workspace docflow build
4444
mkdir -p out
4545
cd packages/cli
46-
yarn pack --out ../../out
46+
yarn pack --out ../../out/docflow-cli.tgz
4747
4848
- id: extract-changelog
4949
uses: dahlia/submark@5a5ff0a58382fb812616a5801402f5aef00f90ce
@@ -75,9 +75,9 @@ jobs:
7575
npm config set //registry.npmjs.org/:_authToken "$NPM_AUTH_TOKEN"
7676
npm whoami
7777
if [[ "$GITHUB_REF_TYPE" = "tag" ]]; then
78-
npm publish --provenance --access public *.tgz
78+
npm publish --provenance --access public docflow-cli.tgz
7979
else
80-
npm publish --provenance --access public --tag dev *.tgz
80+
npm publish --provenance --access public --tag dev docflow-cli.tgz
8181
fi
8282
env:
8383
NPM_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
All notable changes to this project will be documented in this file.
44

5-
## Version v0.0.0
5+
## Version v0.0.1
66

77
Released on July 22nd, 2025.
88

packages/cli/README.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# Docflow · [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/toss/docflow/blob/main/LICENSE) [![NPM badge](https://img.shields.io/npm/v/docflow?logo=npm)](https://www.npmjs.com/package/docflow)
2+
3+
English | [한국어](https://github.com/toss/docflow/blob/main/README-ko_kr.md)
4+
5+
Docflow is a TypeScript-first documentation generator that automatically creates API documentation from JSDoc comments.
6+
7+
- Docflow automatically generates comprehensive documentation from JSDoc comments, supporting essential tags like [@public](https://docflow.dev/reference/public), [@category](https://docflow.dev/reference/category), and [@example](https://docflow.dev/reference/example).
8+
- Designed with AI integration in mind, Docflow can [generate complete JSDoc comments](https://docflow.dev/features/ai-generation) for your functions with a single `@generate` tag.
9+
- Docflow provides [accurate TypeScript type extraction](https://docflow.dev/features/typescript), ensuring your documentation always matches your actual code signatures.
10+
- Docflow includes a powerful plugin system, allowing you to generate documentation for [VitePress](https://docflow.dev/plugins/vitepress), [Docusaurus](https://docflow.dev/plugins/docusaurus), [Nextra](https://docflow.dev/plugins/nextra), and more.
11+
12+
## Examples
13+
14+
```typescript
15+
import { createCalculator } from "@toss/utils";
16+
17+
/**
18+
* @public
19+
* @category Math
20+
* Creates a calculator instance with the given initial value
21+
* @param initialValue - The starting value for calculations
22+
* @returns A calculator object with calculation methods
23+
* @example
24+
* const calc = createCalculator(10);
25+
* calc.add(5).multiply(2).getValue(); // 30
26+
*/
27+
export function createCalculator(initialValue: number) {
28+
return {
29+
add: (n: number) => createCalculator(initialValue + n),
30+
multiply: (n: number) => createCalculator(initialValue * n),
31+
getValue: () => initialValue,
32+
};
33+
}
34+
```
35+
36+
With just `docflow build`, this becomes a beautiful documentation page with examples, type information, and more.
37+
38+
## Contributing
39+
40+
We welcome contribution from everyone in the community. Read below for detailed contribution guide.
41+
42+
[CONTRIBUTING](https://github.com/toss/docflow/blob/main/.github/CONTRIBUTING.md)
43+
44+
## License
45+
46+
MIT © Toss. See [LICENSE](./LICENSE) for details.
47+
48+
<a title="Toss" href="https://toss.im">
49+
<picture>
50+
<source media="(prefers-color-scheme: dark)" srcset="https://static.toss.im/logos/png/4x/logo-toss-reverse.png">
51+
<img alt="Toss" src="https://static.toss.im/logos/png/4x/logo-toss.png" width="100">
52+
</picture>
53+
</a>

packages/cli/package.json

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "docflow",
33
"type": "module",
4-
"version": "0.0.0",
4+
"version": "0.0.1",
55
"exports": {
66
".": "./dist/index.js",
77
"./cli": "./dist/cli.js",
@@ -19,7 +19,8 @@
1919
"lint": "eslint ."
2020
},
2121
"files": [
22-
"dist"
22+
"dist",
23+
"README.md"
2324
],
2425
"engines": {
2526
"node": ">=22.15.1",
@@ -48,5 +49,9 @@
4849
"ts-morph": "^22.0.0",
4950
"unconfig": "^0.3.11",
5051
"zod": "^3.22.4"
52+
},
53+
"repository": {
54+
"type": "git",
55+
"url": "https://github.com/toss/docflow"
5156
}
5257
}

0 commit comments

Comments
 (0)