Feature improve documentation

.github/CONTENTS.md

@@ -1,4 +1,4 @@
-# OSCAL GitHub Supporting Files
+# GitHub Files
 
 This directory contains supporting files for Metaschema GitHub repository use. The structure and contents of the directory are as follows:
 

.github/ISSUE_TEMPLATE/README.md

@@ -1,4 +1,4 @@
-# OSCAL GitHub Issue Template Files
+# GitHub Issue Template Files
 
 This directory contains templates for creating new project issues in GitHub. The structure and contents of the directory are as follows:
 

.github/dependabot.yml

@@ -33,7 +33,6 @@ updates:
     target-branch: "develop"
 
   - package-ecosystem: "npm"
-    directory: "/build"
     schedule:
       interval: "daily"
     target-branch: "develop"

.github/workflows/workflow-generate-website.yml

@@ -109,11 +109,31 @@ jobs:
         go-version-file: '${{ env.BUILD_PATH }}/go.mod'
         cache: true
         cache-dependency-path: '${{ env.BUILD_PATH }}/go.sum'
+    - name: Set up NodeJS
+      uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c
+      with:
+        node-version-file: 'build/.nvmrc'
+        cache: 'npm'
+        cache-dependency-path: 'package-lock.json'
+    - name: Setup Dependencies
+      run: |
+        # NodeJS
+        # If you are a developer and need to modify the workflow, be sure to review
+        # the package.json and package-lock.json to ensure the following deps are
+        # at least installed (they will be updated by dependabot):
+        # - ajv-cli
+        # - ajv-formats
+        # - markdown-link-check
+        # - yaml-convert
+        npm install --loglevel verbose
+        echo "$PWD/node_modules/.bin/" >> $GITHUB_PATH
     - name: Install Hugo
       if: steps.cache-hugo.outputs.cache-hit != 'true'
       run: |
         cd "${{ env.BUILD_PATH }}"
         go install -tags "extended" github.com/gohugoio/hugo
+    - name: Install Dart Sass Embedded
+      run: sudo snap install dart-sass-embedded
     - name: Run Hugo
       run: |
         hugo --config "config.yaml,development-config.yaml" -v --debug --minify
@@ -169,7 +189,7 @@ jobs:
         enable_jekyll: false
         publish_dir: ./website/public
         publish_branch: nist-pages
-        commit_user_name: OSCAL GitHub Actions Bot
-        commit_user_email: oscal@nist.gov
-        commit_author: OSCAL GitHub Actions Bot <oscal@nist.gov>
+        commit_user_name: GitHub Actions Bot
+        commit_user_email: metaschema@nist.gov
+        commit_author: GitHub Actions Bot <metaschema@nist.gov>
         commit_message: Deploying website [ci deploy skip]

.github/workflows/workflow-validate-repo-markdown.yml

@@ -33,11 +33,10 @@ jobs:
       with:
         node-version-file: 'build/.nvmrc'
         cache: 'npm'
-        cache-dependency-path: '**/package-lock.json'
+        cache-dependency-path: 'package-lock.json'
     - name: Setup Dependencies
       run: |
         # NodeJS
-        cd "${{ github.workspace }}/build"
         # If you are a developer and need to modify the workflow, be sure to review
         # the package.json and package-lock.json to ensure the following deps are
         # at least installed (they will be updated by dependabot):

.gitignore

@@ -1,18 +1,17 @@
 # IDE configuration files
 *.xpr
 
-# Files generated by Hugo
+# Files generated by Hugo and related tools
 /website/resources
 /website/public
-
-# files generated by bundler
-/website/.bundle
-/website/vendor
+/website/.hugo_build.lock
+# htmltest
+/website/tmp
 
 
 # other generated files
 nohup.out
 /toolchains/xslt-M4/validate/xspec/metaschema-composition-schematron-result.html
 
 # Ignore NodeJS modules
-node_modules/
+node_modules/

CODE_OF_CONDUCT.md

@@ -34,7 +34,7 @@ This Code of Conduct applies both within project spaces and in public spaces whe
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at oscal@nist.gov. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at metaschema@nist.gov. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
 
 Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
 

build/go.mod

@@ -1,4 +1,4 @@
-module github.com/usnistgov/OSCAL/build
+module github.com/usnistgov/metaschema/build
 
 go 1.18