github publish

.crux_dry_run_build

@@ -0,0 +1,3 @@
+# list of versionsets to run Dry-run Builds in. Used when you make or update a CR.
+AWSDevDocs/public
+AWSDevDocsBJS/public

.gitconfig

@@ -0,0 +1,8 @@
+[difftool "vscode"]
+	cmd = code --wait --diff $LOCAL $REMOTE
+[diff]
+	tool = vscode
+[mergetool "vscode"]
+	cmd = code --wait --merge $REMOTE $LOCAL $BASE $MERGED
+[merge]
+	tool = vscode

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,6 @@
+*Issue #, if available:*
+
+*Description of changes:*
+
+
+By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

.github/workflows/vale.yml

@@ -0,0 +1,27 @@
+name: Style check
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  style-job:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out
+        uses: actions/checkout@v3
+
+        # For AsciiDoc users:
+      - name: Install Asciidoctor
+        run: sudo apt-get install -y asciidoctor
+
+      - name: Run Vale
+        uses: errata-ai/vale-action@reviewdog
+        env:
+          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
+        with:
+          fail_on_error: true
+          reporter: github-pr-check
+          filter_mode: added
+          files: latest/ug
+        continue-on-error: false

.gitignore

@@ -0,0 +1,80 @@
+*.running.properties.txt
+*\~
+*.mobi
+build
+*.DS_Store
+.attach_pid*
+*.7z
+*.action
+*.apk
+*.app
+*.avi
+*.bat
+*.bin
+*.cab
+*.cmd
+*.com
+*.command
+*.cpl
+*.csh
+*.dmg
+*.doc
+*.docx
+*.ex_
+*.exe
+*.gadget
+*.html
+*.inf
+*.ins
+*.inx
+*.ipa
+*.iso
+*.isu
+*.job
+*.jse
+*.ksh
+*.lnk
+*.mov
+*.mp3
+*.mp4
+*.msc
+*.msi
+*.msp
+*.mst
+*.osx
+*.out
+*.paf
+*.pdf
+*.pif
+*.potm
+*.potx
+*.ppam
+*.pptm
+*.pptx
+*.prg
+*.ps1
+*.rar
+*.reg
+*.rgs
+*.rtf
+*.run
+*.scr
+*.sct
+*.shar
+*.shb
+*.shs
+*.tar
+*.u3p
+*.vb
+*.vbe
+*.vbs
+*.vbscript
+*.workflow
+*.ws
+*.wsf
+*.wsh
+*.xls
+*.xlsx
+*.xpr
+vale/styles/AsciiDoc/
+vale/styles/RedHat/

.vale.ini

@@ -0,0 +1,16 @@
+StylesPath = vale/styles
+
+MinAlertLevel = suggestion
+
+Packages = RedHat, AsciiDoc
+
+Vocab = EksDocsVocab
+
+# Ignore files in dirs starting with `.` to avoid raising errors for `.vale/fixtures/*/testinvalid.adoc` files
+[[!.]*.adoc]
+BasedOnStyles = RedHat, AsciiDoc, EksDocs
+RedHat.GitLinks = OFF 
+AsciiDoc.UnsetAttributes = OFF 
+RedHat.CaseSensitiveTerms = suggestion
+RedHat.TermsErrors = warning
+RedHat.Spacing = warning

.vscode/asciidoc.code-snippets

@@ -0,0 +1,185 @@
+{
+    // Place your snippets for AsciiDoc here. Each snippet is defined under a snippet name and has a prefix, body and 
+    // description. The prefix is what is used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+    // $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders. Placeholders with the 
+    // same ids are connected.
+    // Example:
+    // "Print to console": {
+    // 	"prefix": "log",
+    // 	"body": [
+    // 		"console.log('$1');",
+    // 		"$2"
+    // 	],
+    // 	"description": "Log output to console"
+    // }
+    // https://code.visualstudio.com/docs/editor/userdefinedsnippets
+    // https://www.freecodecamp.org/news/definitive-guide-to-snippets-visual-studio-code/
+    "adoc tablist": {
+        "prefix": "tablist",
+        "body": [
+            "====",
+            "[role=\"tablist\"]",
+            "${1:Fargate - [.noloc]`Linux`}::",
+            "+",
+            "[source,bash,subs=\"verbatim,attributes\"]",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code --fargate",
+            "----\n",
+            "${2:Managed nodes - [.noloc]`Linux`}::",
+            "+",
+            "[source,bash,subs=\"verbatim,attributes\"]",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code",
+            "----\n",
+            "===="
+        ],
+        "description": "adoc tablist"
+    },
+    "adoc step tablist": {
+        "prefix": "tab-step",
+        "body": [
+            "====",
+            "[role=\"tablist\"]",
+            "${1:{aws-management-console}`}::",
+            "+",
+            "[source,bash,subs=\"verbatim,attributes\"]",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code --fargate",
+            "----\n",
+            "${2:[.noloc]`eksctl`}::",
+            "+",
+            "[source,bash,subs=\"verbatim,attributes\"]",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code",
+            "----\n",
+            "${3:{aws} CLI}::",
+            "+",
+            "[source,bash,subs=\"verbatim,attributes\"]",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code",
+            "----\n",
+            "${3:{aws} CloudFormation}::",
+            "+",
+            "[source,bash,subs=\"verbatim,attributes\"]",
+            "----",
+            "eksctl create cluster --name my-cluster --region region-code",
+            "----\n",
+            "===="
+        ],
+        "description": "adoc step tablist"
+    },
+    "adoc region tablist": {
+        "prefix": "tab-region",
+        "body": [
+            "====",
+            "[role=\"tablist\"]",
+            "${1:{aws}`}::",
+            "`eks-cluster.[.replaceable]``region``.api.aws`",
+            "\n",
+            "${2:{aws} GovCloud (US)}::",
+            "`eks-cluster.[.replaceable]``region``.api.aws`",
+            "\n",
+            "${3:{amazon-web-services} in China::",
+            "`eks-cluster.[.replaceable]``region``.api.amazonwebservices.com.cn`",
+            "\n",
+            "===="
+        ],
+        "description": "adoc region tablist"
+    },
+    "Code Block": {
+        "prefix": "adoc-code",
+        "body": [
+            "[source,${1|yaml,cli,json,java,python,javascript,ruby,go,bash|}]",
+            "----",
+            "${2:// Your code here}",
+            "----",
+            "$0"
+        ],
+        "description": "Code block with language selection"
+    },
+    "AWS AsciiDoc Link": {
+        "prefix": "adoc-link",
+        "body": [
+        "link:${1:path}[\"${2:link text}\",type=\"${3|documentation,marketing,console,blog,api|}\"]"
+        ],
+        "description": "Create an AWS documentation link in AsciiDoc format"
+    },
+    "Admonition Block": {
+        "prefix": "adoc-admonition",
+        "body": [
+            "[${1|NOTE,TIP,IMPORTANT,CAUTION,WARNING|}]",
+            "====",
+            "${2:Admonition content}",
+            "====",
+            "$0"
+        ],
+        "description": "Admonition block with type selection"
+    },
+    "Table": {
+        "prefix": "adoc-table",
+        "body": [
+            "[%header,cols=\"${1:1,1}\"]",
+            "|===",
+            "| ${2:Header 1} | ${3:Header 2}",
+            "",
+            "| ${4:Cell 1} | ${5:Cell 2}",
+            "|===",
+            "$0"
+        ],
+        "description": "Basic table with headers"
+    },
+    "Cross Reference": {
+        "prefix": "adoc-xref",
+        "body": [
+            "<<${1:anchor-id},${2:display text}>>$0"
+        ],
+        "description": "Cross-reference link"
+    },
+    "Definition List": {
+        "prefix": "adoc-deflist",
+        "body": [
+            "${1:Term 1}::",
+            "${2:Definition 1}",
+            "",
+            "${3:Term 2}::",
+            "${4:Definition 2}",
+            "$0"
+        ],
+        "description": "Definition list"
+    },
+    "NODE_ROOT Section": {
+        "prefix": "adoc-topic",
+        "body": [
+            "//!!NODE_ROOT <section>",
+            "[.topic]",
+            "[[${1:page-id},${1:page-id}.title]]",
+            "= ${2:page title goes here}",
+            ":info_doctype: section",
+            "",
+            "include::../attributes.txt[]",
+            "",
+        ],
+        "description": "Creates a NODE_ROOT section template with topic class and ID"
+    },
+    "Include with Leveloffset": {
+        "prefix": "adoc-inc",
+        "body": [
+            "include::${1:filename}.adoc[leveloffset=+1]$0"
+        ],
+        "description": "Creates an include statement with leveloffset=+1, automatically adding .adoc extension"
+    },
+    "AsciiDoc Collapsible Section": {
+        "prefix": "adoc-collapse",
+        "body": [
+            "[[${1:collapsible-section-id},${1:collapsible-section-id}.title]]",
+            ".${2:Section Title}",
+            "[%collapsible, expand-section=\"_collapse_all_\"]",
+            "====",
+            "${3:This is where the text to collapse goes.}",
+            "===="
+        ],
+        "description": "Creates a collapsible section in AsciiDoc"
+    }
+}

.vscode/tasks.json

@@ -0,0 +1,35 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Convert and Open AsciiDoc",
+            "type": "shell",
+            "command": "bash",
+            "args": [
+                "-c",
+                "asciidoctor ${file} && open ${fileDirname}/${fileBasenameNoExtension}.html"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "presentation": {
+                "reveal": "always",
+                "panel": "shared",
+                "showReuseMessage": false,
+                "clear": true
+            },
+            "problemMatcher": [],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            }
+        }
+    ],
+    "inputs": [
+        {
+            "id": "currentFile",
+            "type": "command",
+            "command": "extension.commandvariable.file.filePath"
+        }
+    ]
+}