Skip to content

Commit bee8c8c

Browse files
authored
Merge pull request #3 from typescript-template/issue-2
[Issue #2] Move development documentation out of readme
2 parents 3b819df + de6c145 commit bee8c8c

6 files changed

Lines changed: 39 additions & 33 deletions

File tree

.gitignore

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,3 @@ dist/
4747

4848
# Environment Variables
4949
.env
50-
51-
# Docs build
52-
docs/

README.md

Lines changed: 2 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,5 @@
11
# {{project-name}} - Readme
22

3-
## Development
3+
## Contributing & Development
44

5-
Run a dev test with `npm start`.
6-
7-
## Running Tests
8-
9-
To run unit tests, `npm run test`
10-
11-
## Scripts
12-
13-
You can write custom scripts in the `script/` directory. See `script/example.ts` as an example.
14-
15-
Run your script with `npm run script -- example`
16-
17-
## Compiling
18-
19-
### Debug Builds
20-
21-
To compile a debug build, run `npm run build`. The build output will appear in the `./dist` folder.
22-
23-
### Prod Builds
24-
25-
To compile a production build, run `npm run lint:prod && npm run build`. The build output will appear in the `./dist` folder.
26-
27-
## More
28-
29-
### Generating Docs
30-
31-
`npm run doc` and browse docs/index.html!
5+
See [contributing.md](docs/contributing/contributing.md) for information on how to develop or contribute to this project!

docs/.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
typedoc/

docs/contributing/contributing.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Contributing
2+
3+
## Development Guide
4+
5+
See the [development guide](development.md) for development documentation.

docs/contributing/development.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Development
2+
3+
Run a dev test with `npm start`.
4+
5+
## Running Tests
6+
7+
To run unit tests, `npm run test`
8+
9+
## Scripts
10+
11+
You can write custom scripts in the `script/` directory. See `script/example.ts` as an example.
12+
13+
Run your script with `npm run script -- example`
14+
15+
## Compiling
16+
17+
### Debug Builds
18+
19+
To compile a debug build, run `npm run build`. The build output will appear in the `./dist` folder.
20+
21+
### Prod Builds
22+
23+
To compile a production build, run `npm run lint:prod && npm run build`. The build output will appear in the `./dist` folder.
24+
25+
## More
26+
27+
### Generating Docs
28+
29+
`npm run doc` and browse docs/index.html!

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
"name": "{{project-name}}",
33
"version": "1.0.0",
44
"typescript-template": {
5-
"base": "1.0.0"
5+
"base": "1.0.1"
66
},
77
"scripts": {
88
"build": "tsc",
99
"start": "ts-node src/index",
1010
"test": "npm run lint",
11-
"doc": "typedoc --out docs src",
11+
"doc": "typedoc --out docs/typedoc src",
1212
"format": "prettier-eslint --write **/*.*",
1313
"lint": "eslint .",
1414
"lint:prod": "npm run lint -- --config=.eslintrc.prod.json",

0 commit comments

Comments
 (0)