[Docs] Remove some redundant notes & small updates (#2847)

* remove outdated notes

* Update general.md

* Update creating-slash-commands.md

* Update add note about interaction framework

* typo

* use xref

* Update intro.md

* improve docs workflow

* Update README.md

.github/workflows/docs.yml

@@ -4,7 +4,14 @@ on:
   push:
     tags:
       - '*'
+    paths:
+      - 'docs/**'
   workflow_dispatch:
+  pull_request:
+    paths:
+      - 'docs/**'
+    branches:
+      - dev
       
 jobs:
   build:
@@ -24,9 +31,26 @@ jobs:
     - name: Build DNet docs
       run: docfx docs/docfx.json
 
-    - name: Create Output Directory
-      run: mkdir output | cp -a docs/_site/. output/
-        
+    - name: Upload Artifacts 
+      uses: actions/upload-artifact@v4
+      with:
+        name: static-docs
+        path: docs/_site
+  
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build 
+    if: startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch'
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Download Artifacts
+      uses: actions/download-artifact@v2
+      with:
+        name: static-docs
+        path: output/
+    
     - name: Auth DNet bot
       id: bot_auth
       uses: machine-learning-apps/actions-app-token@master
@@ -34,7 +58,7 @@ jobs:
         APP_PEM: ${{ secrets.DNET_BOT_PEM }}
         APP_ID: ${{ secrets.DNET_BOT_ID }}
 
-    - name: Push to static docs
+    - name: Push to the Docs Repo
       uses: cpina/github-action-push-to-another-repository@main
       env:
         API_TOKEN_GITHUB: ${{ steps.bot_auth.outputs.app_token }}