Skip to content

Commit 6f1bff1

Browse files
committed
Added restructure plans
1 parent 07dbd56 commit 6f1bff1

File tree

20 files changed

+11494
-3
lines changed

20 files changed

+11494
-3
lines changed

.claude/settings.json

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,5 +16,8 @@
1616
"Bash(find . -delete)",
1717
"Bash(find ~ -delete)"
1818
]
19+
},
20+
"env": {
21+
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000"
1922
}
2023
}

fix_markdown_references.sh

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ if [ ! -d "$search_dir" ]; then
2323
exit 1
2424
fi
2525

26-
# Process CSV file (skip header)
27-
tail -n +2 "$csv_file" | while IFS=',' read -r source_path dest_path; do
26+
# Process CSV file
27+
while IFS=',' read -r source_path dest_path; do
2828
# Remove any leading/trailing whitespace
2929
source_path=$(echo "$source_path" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
3030
dest_path=$(echo "$dest_path" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
@@ -55,6 +55,6 @@ tail -n +2 "$csv_file" | while IFS=',' read -r source_path dest_path; do
5555
fi
5656
fi
5757
done
58-
done
58+
done < "$csv_file"
5959

6060
echo "Path replacement complete"

prompt.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
## Role
2+
3+
You are a senior technical writer who is assisting with the restructuring of technical product documentation within a docusaurus site.
4+
5+
## Task
6+
7+
You need to create a plan to restructure the documentation structure of the directorymanager/11.0 product documentation, located at /docs/directorymanager/11.0, and create a sidebar file that:
8+
9+
- utilizes information architecture best practices
10+
11+
- Follows the Docusaurus documentation for creating docs and sidebars at `reference-docs/docusaurus/docs/guides/docs`
12+
13+
- Uses `reference-docs/docusaurus/sidebars.ts` for an example of a sidebar and /reference-docs/docusaurus/docs/guides/docs for an example of the documentation that the example sidebar references
14+
15+
Think deep and hard about how you would restructure the documentation and `sidebar.js` file for directorymanager/11.0 to make more sense for a human. Consider the following:
16+
17+
- Make sure all categories and docs use title case
18+
19+
- Reduce the total number of categories and docs by intelligently combining them.
20+
21+
## Steps
22+
23+
1. Run `tree docs/directorymanager/11.0` to generate a view of the current directory.
24+
2. Create a new directory structure using the same format as the `tree` command above. Use snake case with hyphens for file and directory names (ex. `docs/directorymanager/11.0/Getting Started` becomes `docs/directorymanager/11.0/getting-started`). Do not use underscores. Save the new structure to `restructure/directorymanager/11.0/proposed-structure.md`.
25+
3. Save the restructure plan file to `restructure/directorymanager/11.0/plan.md`.
26+
4. Map all files in the current directory structure to where their new location will be in the new directory structure. Do this as efficiently as possible to reduce the number of output tokens needed to create the mappings.
27+
1. If files are changing directories, then show the new directory path. For example, if a file currently exists at `docs/directorymanager/11.0/admin/login.md`, and you determine it should now exist at `docs/directorymanager/11.0/gettting-started/login.md`, then the mapping file should look like this:
28+
```text
29+
docs/directorymanager/11.0/admin/login.md,docs/directorymanager/11.0/gettting-started/login.md
30+
```
31+
2. If files are getting merged into another file, show the path to the new file. For example, ff `docs/directorymanager/11.0/integrations/servicenow.md`, `docs/directorymanager/11.0/integrations/connectwise.md`, and `docs/directorymanager/11.0/integrations/sharepoint-online.md` all need to be merged into a single file in the new directory structure at `docs/directorymanager/11.0/integrations/index.md`, then the mapping file should look like this:
32+
```text
33+
docs/directorymanager/11.0/integrations/servicenow.md,docs/directorymanager/11.0/integrations/index.md
34+
docs/directorymanager/11.0/integrations/connectwise.md,docs/directorymanager/11.0/integrations/index.md
35+
docs/directorymanager/11.0/integrations/sharepoint-online.md,docs/directorymanager/11.0/integrations/index.md
36+
```
37+
3. The new directories and files must exist in the new directory structure created in step 2 above.
38+
5. Save the restructure mappings file to `restructure/directorymanager/11.0/file-mappings.csv`. Do not include a header on line 1. Make sure there is a newline at the end of the file.
39+
6. Get a list of all files using `find docs/directorymanager/11.0 -type f` and validate that every file from the output of this command exists in `restructure/directorymanager/11.0/file-mappings.md`.
40+
7. Generate a `sidebar.js` file for the restructured directory. Save it to `sidebars/directorymanager/11.0.js`.

0 commit comments

Comments
 (0)