Skip to content

Commit 9104006

Browse files
authored
Merge pull request #236 from team-dev-docs/dev-docs-Dev-Docs_Update_2024-10-22_13-03-25
Dev-Docs Update
2 parents 072ba10 + 9eb036b commit 9104006

File tree

1 file changed

+61
-0
lines changed

1 file changed

+61
-0
lines changed
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
2+
3+
# Configuring dev-docs.json for GitHub App Documentation Generation
4+
5+
This guide will walk you through the process of configuring the `dev-docs.json` file to enable automatic documentation generation using the Dev-Docs GitHub App.
6+
7+
## Step 1: Locate the dev-docs.json file
8+
9+
The `dev-docs.json` file should be located in the root directory of your repository.
10+
11+
## Step 2: Basic Structure
12+
13+
Ensure your `dev-docs.json` file has the following basic structure:
14+
15+
```json
16+
{
17+
"gitHubApp": {
18+
"workflows": []
19+
}
20+
}
21+
```
22+
23+
## Step 3: Configure Workflows
24+
25+
To enable documentation generation, add the `generateDocs` workflow to the `workflows` array:
26+
27+
```json
28+
{
29+
"gitHubApp": {
30+
"workflows": ["generateDocs"]
31+
}
32+
}
33+
```
34+
35+
Note: The `workflows` array accepts specific enum values. Currently, the supported values are:
36+
37+
- `generateDocs`: Enables automatic documentation generation
38+
- `generateChangelog`: Enables automatic changelog generation
39+
40+
## Step 4: Additional Configuration (Optional)
41+
42+
Depending on your project's needs, you may want to add more configuration options. For example:
43+
44+
```json
45+
{
46+
"ai":{
47+
"contextDirs": ["src", "lib"],
48+
},
49+
"gitHubApp": {
50+
"workflows": ["generateDocs"]
51+
}
52+
}
53+
```
54+
55+
## Step 5: Commit and Push
56+
57+
After configuring your `dev-docs.json` and installing the GitHub app, commit the changes and push them to your repository.
58+
59+
60+
61+

0 commit comments

Comments
 (0)