Skip to content

Commit f27aa92

Browse files
authored
Merge branch 'main' into jaisch01-maintain-performix-install-guide
2 parents 45a2708 + ba2f471 commit f27aa92

105 files changed

Lines changed: 3190 additions & 466 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/skills/code-sample-review/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Check for:
4646
## Workflow
4747

4848
1. Identify the review scope and whether the request is editorial, technical, or mixed.
49-
2. Inspect surrounding prose before judging a code block; code samples should be evaluated in context.
49+
2. Inspect surrounding prose before judging a code block; code samples should be evaluated in context. If you've previously read the page, use context and don't re-read it unless there's a change since the last read.
5050
3. Depending on the type of review, suggest fixes as follows:
5151
- For review requests, report issues by file and line when possible, ordered by learner impact.
5252
- For edit requests, report issues and suggest focused changes that preserve technical intent and existing repository patterns.
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
name: draft-learning-path
3+
description: "Toggle draft mode on a Learning Path _index.md. Use when: marking a learning path as draft, hiding a learning path from publication, adding draft: true to front matter, unpublishing or disabling a learning path, removing draft, publishing a learning path, taking a learning path out of draft."
4+
---
5+
6+
# Draft Learning Path
7+
8+
Sets `draft: true` and `cascade: draft: true` in the front matter of a Learning Path `_index.md` file so the page and all its child pages are excluded from the published site.
9+
10+
For new content intake where the goal is to prevent unreviewed content from publishing, use `.github/skills/intake-metadata-update/SKILL.md` instead.
11+
12+
## Draft block to insert
13+
14+
The following YAML must be added to the front matter, after the `title:` field. Leave a blank line between `title:` and the draft block for readability:
15+
16+
```yaml
17+
title: Your Learning Path Title
18+
19+
draft: true
20+
cascade:
21+
draft: true
22+
```
23+
24+
## Workflow
25+
26+
1. **Identify the target file**
27+
- If the user specifies a path, use that.
28+
- Otherwise, use the currently open or most recently edited `_index.md` file in the workspace.
29+
- Confirm the file is a Learning Path `_index.md` (contains Hugo front matter between `---` markers).
30+
31+
2. **Read the file**
32+
- Read the file to inspect the existing front matter.
33+
34+
3. **Apply the draft block**
35+
- If `draft: true` and `cascade:` with `draft: true` already exist, inform the user it is already in draft mode and stop.
36+
- If a `draft:` field exists but no `cascade:` block, replace the existing `draft:` line with the full draft block above.
37+
- If no `draft:` field exists, insert the draft block after the `title:` field, with a blank line between them.
38+
39+
4. **Confirm**
40+
- Report the file path and confirm the draft block has been set.
41+
- Remind the user that Hugo will exclude this file and all child pages from the built site until the draft block is removed.
42+
43+
## Undraft workflow
44+
45+
If the user asks to publish, undraft, or remove draft mode:
46+
47+
1. **Identify the target file** (same as above).
48+
2. **Read the file** to locate the draft block.
49+
3. **Remove the draft block**
50+
- Remove the `draft: true` line.
51+
- Remove the `cascade:` block (`cascade:` and its indented `draft: true` child line).
52+
- Remove any blank line that was added between `title:` and the draft block, restoring the original spacing.
53+
- If no draft block exists, inform the user the file is already published and stop.
54+
4. **Confirm**
55+
- Report the file path and confirm draft mode has been removed.
56+
- Remind the user the Learning Path will now appear on the published site.

.github/skills/link-text-review/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ This skill focuses on anchor text and link clarity. For tables, notices, tab pan
1818

1919
## Workflow
2020

21-
1. Identify the target file, directory, section, or selected text.
21+
1. Identify the target file, directory, section, or selected text. If you've previously read the page, use context and don't re-read it unless there's a change since the last read.
2222
2. Read surrounding context before suggesting any changes.
2323
3. After understanding the context of the URL, suggest concise and natural rewrites to the anchor text based on `Quality rules`.
2424
4. After the user accepts suggestions, make changes, then re-open or search changed lines to verify the Markdown link syntax is valid.

.github/skills/markdown-component-edit/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ This skill is best when the user highlights text, names a section, or asks for a
1818

1919
## Workflow
2020

21-
1. Use the user's highlighted, selected, or explicitly named text as the edit target. If the target is ambiguous, ask for the exact text, file, or section before editing.
21+
1. Use the user's highlighted, selected, or explicitly named text as the edit target. If the target is ambiguous, ask for the exact text, file, or section before editing. If you've previously read the page, use context and don't re-read it unless there's a change since the last read.
2222
2. Inspect nearby Markdown so the new component fits the surrounding flow.
2323
3. Verify internal links before adding or changing them when practical.
2424
4. Use `component rules` and the `component-patterns` reference and do one of the following:

.github/skills/metadata-description-update/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ This skill is for search and discovery metadata. For draft visibility metadata,
3131
## Workflow
3232

3333
1. Identify whether the target is an install guide content page, a Learning Path `_index.md`, or a Learning Path content page.
34-
2. Read the title, existing description, headings, introduction, task flow, code or command context, and validation or conclusion.
34+
2. Read the title, existing description, headings, introduction, task flow, code or command context, and validation or conclusion. If you've previously read the page, use context and don't re-read it unless there's a change since the last read.
3535
3. Add or revise the `description` field in front matter based on quality rules.
3636
4. After editing, re-open or search the files to verify each changed target has one `description` field.
3737
5. Report files changed and note any skipped files.

.github/skills/seo-geo-aeo-review/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ For focused front matter `description` edits only, use `.github/skills/metadata-
2323

2424
## Workflow
2525

26-
1. Identify the target content type and target developer intent.
27-
2. Read the title, front matter description, headings, introduction, prerequisites, main task flow, validation, conclusion, and further reading.
26+
1. Identify the target content type and target developer intent.
27+
2. Read the title, front matter description, headings, introduction, prerequisites, main task flow, validation, conclusion, and further reading. If you've previously read a page, use context and don't re-read it unless there's a change since the last read.
2828
3. State the page's owned task in one sentence. If the task is unclear or too broad, flag it.
2929
4. Review SEO signals:
3030
- The title is task-led and includes the main technology, platform, or tool.

.github/skills/writing-style-review/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Use this skill for granular prose, voice, readability, terminology, and style re
1010
## Workflow
1111

1212
1. Identify the target file, section, or selected text.
13-
2. Read surrounding context so style edits preserve the author's intent and the technical flow.
13+
2. Read surrounding context so style edits preserve the author's intent and the technical flow. If you've previously read the page, use context and don't re-read it unless there's a change since the last read.
1414
3. Review the target against the guidelines defined in this skill.
1515
4. Depending on request type, do the following:
1616
- For review requests, report high-impact style issues by file and line when possible.

.gitignore

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ package-lock.json
88
.vscode
99
.env
1010
startup.sh
11-
data/
1211

1312
# macOS files
1413
*.DS_Store
@@ -26,4 +25,4 @@ z_local_saved/
2625
tags
2726

2827
# Generated spell check config
29-
.spellcheck-non-draft.yml
28+
.spellcheck-non-draft.yml

assets/contributors.csv

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -128,3 +128,4 @@ Sabika Tasneem,Memgraph,,,,
128128
Anupras Mohapatra,Arm,,,,
129129
Tomas Agustin Gonzalez Orlando,Arm,tgonzalezorlandoarm,tgorlando,,
130130
Jai Adam Schrem,Arm,jai-adam-schrem,jai-adam-s-395bb1233,,
131+
Steve Jordahl,Rafay,,,,

0 commit comments

Comments
 (0)