Skip to content

Commit 1f2d85e

Browse files
committed
feat: rename folder from doc to docs
1 parent fd467d7 commit 1f2d85e

29 files changed

+435
-138
lines changed

README.md

Lines changed: 24 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
[![Issues](https://img.shields.io/github/issues-raw/deven-org/documentation-skeleton.svg?maxAge=25000)](https://github.com/deven-org/documentation-skeleton/issues)
66
[![GitHub pull requests](https://img.shields.io/github/issues-pr/deven-org/documentation-skeleton.svg?style=flat)](https://github.com/deven-org/documentation-skeleton/pulls)
7-
[![Code of Conduct](https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat)](https://github.com/deven-org/documentation-skeleton/blob/main/doc/CODEOFCONDUCT.md)
7+
[![Code of Conduct](https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat)](https://github.com/deven-org/documentation-skeleton/blob/main/doc/CODE_OF_CONDUCT.md)
88
[![GitHub contributors](https://img.shields.io/github/contributors/deven-org/documentation-skeleton.svg?style=flat)](https://github.com/deven-org/documentation-skeleton/)
99
![Coverage](https://img.shields.io/badge/Code%20Coverage-83%25-success?style=flat)
1010

@@ -13,21 +13,21 @@
1313
## :information_source: Table of contents
1414

1515
- [Deven Documentation Skeleton](#deven-documentation-skeleton)
16-
- [:information\_source: Table of contents](#information_source-table-of-contents)
16+
- [:information_source: Table of contents](#information_source-table-of-contents)
1717
- [:star: Introduction](#star-introduction)
1818
- [Goals](#goals)
19-
- [:file\_folder: Documentation Structure](#file_folder-documentation-structure)
19+
- [:file_folder: Documentation Structure](#file_folder-documentation-structure)
2020
- [Requirements](#requirements)
2121
- [Installation](#installation)
2222
- [:rocket: How to use it](#rocket-how-to-use-it)
2323
- [1. Install](#1-install)
2424
- [2. Check](#2-check)
2525
- [3. Update](#3-update)
26-
- [:white\_check\_mark: How to test](#white_check_mark-how-to-test)
26+
- [:white_check_mark: How to test](#white_check_mark-how-to-test)
2727
- [:v: Contribute](#v-contribute)
2828
- [:bug: Bugs and Issues](#bug-bugs-and-issues)
29-
- [:page\_facing\_up: License](#page_facing_up-license)
30-
- [:green\_heart: Code of conduct](#green_heart-code-of-conduct)
29+
- [:page_facing_up: License](#page_facing_up-license)
30+
- [:green_heart: Code of conduct](#green_heart-code-of-conduct)
3131

3232
# :star: Introduction
3333

@@ -46,15 +46,15 @@ The purpose of this "documentation skeleton" project is to provide a simple way
4646
## :file_folder: Documentation Structure
4747

4848
.
49-
└── src/doc
49+
└── src/docs
5050
└── README.md
5151
└── ARCHITECTURE.md
52-
└── CODEOFCONDUCT.md
52+
└── CODE_OF_CONDUCT.md
5353
└── CONTRIBUTE.md
5454
└── DEPLOYMENT.md
55-
└── GETSTARTED.md
55+
└── GET_STARTED.md
5656
└── GLOSSARY.md
57-
└── PROJECTBACKGROUND.md
57+
└── PROJECT_BACKGROUND.md
5858
└── TESTING.md
5959

6060
## Requirements
@@ -75,10 +75,11 @@ The purpose of this "documentation skeleton" project is to provide a simple way
7575
To install the package in your project follow these steps:
7676

7777
install the package:
78-
78+
7979
```bash
8080
npm install @deven-org/documentation-skeleton --save-dev
8181
```
82+
8283
or
8384

8485
```bash
@@ -115,11 +116,11 @@ yarn doc:install
115116
<summary>What to expect?</summary>
116117
<br />
117118

118-
First of all a new folder will be created (`./doc`) containing all the skeleton chapters.
119+
First of all a new folder will be created (`./docs`) containing all the skeleton chapters.
119120
Then it will be generated a config (`./.deven-skeleton-install.config`) which will track the installed version.
120121

121-
If the `./doc` folder exists already, it will be renamed to `./_doc` and a new `doc` folder will be generated.
122-
If both the `doc` folder and the `_doc` folder are existing, the script won't proceed until you don't delete one of them.
122+
If the `./docs` folder exists already, it will be renamed to `./_docs_backup_please_rename` and a new `docs` folder will be generated.
123+
If both the `docs` folder and the `_docs_backup_please_rename` folder are existing, the script won't proceed until you don't delete one of them.
123124

124125
If the `./.deven-skeleton-install.config` is already existing, the script will just stop. It means that the documentation skeleton has been already succesfully installed and there's no need to proceed with a new installation.
125126

@@ -144,15 +145,18 @@ yarn doc:check
144145
<br />
145146

146147
The tool will show the `diff` between the skeleton chapters and the chapters located in the local documentation folder.
147-
If other files have been added to the `doc` folder, they will be ignored.
148+
If other files have been added to the `docs` folder, they will be ignored.
148149

149150
The content of the chapters won't be analysed nor considered for this report.
150151

151152
</details>
152153

153154
### 3. Update
154155

155-
In case one or more chapters are missing in the local documentation folder, the command `update` will clone them into the `doc` folder.
156+
In case a previous version that used the `doc` folder instead of `docs`, the command `update` will try to rename the folder if no other `docs` folder already exists. Otherwise an error will be shown and the process will be aborted.
157+
Furthermore some of the files will be renamed: `CODEOFCONDUCT.md` to `CODE_OF_CONDUCT.md`, `GETSTARTED.md` to `GET_STARTED.md` and `PROJECTBACKGROUND.md` to `PROJECT_BACKGROUND.md`.
158+
159+
In case one or more chapters are missing in the local documentation folder, the command `update` will clone them into the `docs` folder.
156160

157161
```bash
158162
npm run doc:update
@@ -180,21 +184,21 @@ If the local version is greater than the one of the installed packaged, the scri
180184

181185
# :white_check_mark: How to test
182186

183-
[Read more](./doc/TESTING.md)
187+
[Read more](./docs/TESTING.md)
184188

185189
# :v: Contribute
186190

187-
[Read more](./doc/CONTRIBUTE.md)
191+
[Read more](./docs/CONTRIBUTE.md)
188192

189193
# :bug: Bugs and Issues
190194

191195
If you would like to open an issue, you can gladly use [this page](https://git.sinnerschrader.com/deven/documentation-skeleton/-/issues).
192-
But please, have a look at the [Contribute](./doc/CONTRIBUTE.md) page before filing a bug.
196+
But please, have a look at the [Contribute](./docs/CONTRIBUTE.md) page before filing a bug.
193197

194198
# :page_facing_up: License
195199

196200
[MIT LICENCE](./LICENSE.md)
197201

198202
# :green_heart: Code of conduct
199203

200-
You can find the [Code of Conduct here](./doc/CODEOFCONDUCT.md)
204+
You can find the [Code of Conduct here](./docs/CODE_OF_CONDUCT.md)
File renamed without changes.
File renamed without changes.
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Welcome to our docs contributing guide <!-- omit in toc -->
22

33
Thank you for investing your time in contributing to our project! We sincerely appreciate it. :sparkles:.
4-
Please, read our [Code of Conduct](./CODEOFCONDUCT.md) to keep our community approachable and respectable.
4+
Please, read our [Code of Conduct](./CODE_OF_CONDUCT.md) to keep our community approachable and respectable.
55

66
## Content
77

88
- [New contributor guide](#new-contributor-guide)
99
- [Getting started](#getting-started)
1010
- [:file_folder: File Structure](#file_folder-file-structure)
1111
- [Issues](#issues)
12-
- [Create a new issue](#create-a-new-issue)
12+
- [Create a new issue](#create-a-new-issue)
1313
- [Solve an issue](#solve-an-issue)
1414
- [Prerequisites](#prerequisites)
1515
- [Commits](#commits)
@@ -33,7 +33,7 @@ To get an overview of the project, read the [README](../README.md). Here are som
3333
└── __tests__ // Unit test (*.spec.ts)
3434
└── commands // CLI's commands classes
3535
└── shared // Global configuration and log messages
36-
└── doc // the documentation skeleton
36+
└── docs // the documentation skeleton
3737
└── config // the configuration file blueprint
3838
└── dist // build output
3939
└── bin // cli entrypoint
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

doc/TESTING.md renamed to docs/TESTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ beforeEach(() => {
5454
mockLog = mockConsoleLog();
5555
mockFs({
5656
fake_test_folder: {},
57-
"src/doc": mockFs.load(path.resolve("src/doc"), {
57+
"src/docs": mockFs.load(path.resolve("src/docs"), {
5858
lazy: false,
5959
}),
6060
"src/root": mockFs.load(path.resolve("src/root"), {

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
"files": [
1313
"dist/",
1414
"bin/",
15-
"src/doc",
15+
"src/docs",
1616
"src/root",
1717
"CHANGELOG.md",
1818
"LICENSE",

0 commit comments

Comments
 (0)