fix: fixed race condition

between the docfx menu and the wordpress one

Author: bchhun

doc/README.md

@@ -0,0 +1,40 @@
+# Documentation Uno
+
+This folder contains source code for the generation of uno's documentation
+
+# Running a local environement
+
+## Install dependencies
+
+Download and install docfx on your computer.
+
+### MacOS
+
+```
+brew install docfx
+```
+
+### Windows
+
+```
+choco install docfx
+```
+
+```
+npm install
+```
+
+## To see your changes run
+```
+gulp
+```
+
+## and to build the documentation use
+
+```
+npm run generate
+```
+
+The local environement is usually located on port `3000` unless another process is already using it.
+
+You have to remove the `docs` fragment from the wordpress menu to reach your local documentation server.

doc/docfx.json

@@ -1,25 +1,4 @@
 {
-  //"metadata": [
-  //  {
-  //    "src": [
-  //      {
-  //        "src": "../src",
-  //        "exclude": [
-  //          "SolutionTemplate/**",
-  //          "SourceGenerators/SourceGeneratorsConsole/**",
-  //          "SourceGenerators/System.Xaml/**",
-  //          "T4Generator/**",
-  //          "ResourceConverter/**"
-  //        ],
-  //        "files": [
-  //          "**.csproj"
-  //        ]
-  //      }
-  //    ],
-  //    "dest": "api",
-  //    "disableGitFeatures": false
-  //  }
-  //],
   "build": {
     "content": [
       {

doc/package.json

@@ -15,5 +15,8 @@
     "gulp-sourcemaps": "^2.6.4"
   },
   "description": "nventive gulp automation",
-  "main": "gulpfile.js"
+  "main": "gulpfile.js",
+  "scripts": {
+      "generate": "docfx docfx.json"
+  }
 }