Skip to content

Commit 330b0f2

Browse files
committed
Updated developer docs: 2024-10-09T18:55:17+0000
1 parent 9dbaa38 commit 330b0f2

12 files changed

+73
-303
lines changed

docs/Dev-Docs-Quickstart.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
sidebar_position: 2
3+
---
4+
5+
6+
# Quickstart
7+
8+
See Dev-Docs in action in just a under five minutes! First, you'll need an account. If you haven't made one yet, head to [dev-docs.io](https://www.dev-docs.io/) to create a free account in just a few clicks by logging in with your GitHub (no cc required). If you already have one then you're ready to go! Woohoo!
9+
10+
<br></br>
11+
12+
To get started, open our hello world repo that has a sample `dev-docs.json` file already configured.
13+
14+
<br></br>
15+
16+
[Open our sample repo in GitHub Codespaces](https://codespaces.new/team-dev-docs/spriteAI)
17+
18+
<br></br>
19+
20+
Once open follow these steps.
21+
22+
## Get Dev-Docs Extension Setup
23+
24+
### Step 1: Install the Extension
25+
26+
Search for Dev-Docs in the extensions tab and install it.
27+
28+
![](/img/install_the_vscode_extension/step_4.png)
29+
30+
### Step 2: Sign into Dev-Docs in VS Code
31+
32+
Click on the Dev-Docs extension button in your GitHub Codespace or VS Code Editor. Select sign in and then follow the steps to select the org you created when you set up your account.
33+
34+
## Create Onboarding Docs on a codefile
35+
36+
![](/img/customize_your_ai_generation/step_1.png)
37+
38+
### Step 1: Open the index.js file
39+
40+
Open the `index.js` file.
41+
42+
![This is the image for DIV with the text: index.js and then clicked](/img/devdocs_quickstart/step_2.png)
43+
44+
### Step 2: Generate Documentation
45+
46+
Right click on `index.js` and find the `dev-docs` submenu and click `generate documentation`.
47+
48+
![This is the image for DIV with the text: and then clicked](/img/devdocs_quickstart/step_3.png)
49+
50+
### Step 3: Open up the documentation
51+
52+
Wait for the documentation to generate, and then right click to open the context menu and click `Open Dev-doc for current file`. Boom! You are done. What you're seeing is our VS Code extension rich text editor allowing you to view and edit the content directly from your IDE and next to the codebase. The output gets stored as a markdown file in the automatically created dev-docs folder in your repo.
53+
54+
![Open Dev-doc and then clicked](/img/devdocs_quickstart/step_4.png)
55+
56+
<br></br>
57+
58+
## Generate user-facing documentation
59+
60+
### Step 1: Click on the 'dev-docs: Populate External Docs' option to generate user-facing content for your public docs
61+
62+
Open the command palette with `shift cmd P`, and find/click on the 'dev-docs: Populate External Docs' option.
63+
64+
![This is the image for SPAN with the text: dev-docs: Populate External Docs and then clicked](/img/devdocs_quickstart/step_5.png)
65+
66+
## How it works
67+
68+
This codebase has the `dev-docs.json` preconfigured to filter out specific aspects of the codebase to documentation as well as custom options to augment/customize the documentation. When using Dev-Docs, you'll always have full control over what gets documented, what format you want it in, and where the output gets pushed to. Of course, you have final editing powers as well.
69+
70+

docs/Initial-Setup/Dev-Docs-Quickstart.md

Lines changed: 0 additions & 70 deletions
This file was deleted.

docs/Initial-Setup/_category_.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"label": "Initial Setup and Quickstart",
2+
"label": "Initial Setup",
33
"position": 3,
44
"link": {
55
"type": "generated-index"
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)