docfx.json

{
  "metadata": [
    {
      // generate meta data for api docs
      "src": [
        {
          "files": [ "**/*.sln", "**/*.cs" ],
          "exclude": [ "**/bin/**", "**/obj/**" ],
          "src": "Assets"
        }
      ],
      "dest": "obj/api"
    }
  ],
  "build": {
    "content": [
      {
        // generate html for api docs
        "files": [ "**/*.yml"],
        "src": "obj/api", // temp meta data folder from previous step
        "dest": "api"
      },
      {
        // generate html for conceptual docs
        "files": ["*.md", "*.yml", //root dir md and toc files
                "Documentation/**/*.md", "Assets/**/*.md", "External/Documentation/**/*.md", "External/HowTo/**/*.md", // conceptual docs subfolders md files
				"Documentation/**/*.yml", "Assets/**/*.yml" // conceptual docs subfolders toc yml files
                ]
      }
    ],
    "resource": [
      // resource files that will be copied over without modifications
      {
        // website related resource files
        "files": ["index.html", "web/**"],
      },
      {
        // resources documentation is referring to (eg images, videos, audio, etc)
        "files": [ "External/ReadMeImages/**", "External/Documentation/Images/**" ],
      },
    ],
    "template": [
        // gets default template (html/css/jscript) from docfx and copies subsequent templates on top
        "default",
        "templates/mrtk"
    ],
    "globalMetadata": {
      // global docfx config - see docfx documentation for more config params (https://dotnet.github.io/docfx/tutorial/docfx.exe_user_manual.html)
      "_appTitle": "Mixed Reality Toolkit Documentation",
      "_enableSearch": true,
      "_disableNavbar": false,
      "_appLogoPath": "External/ReadMeImages/mrt_logo_icon.png",
      "_appFaviconPath": "External/ReadMeImages/favicon.ico"
      // re-add this section if you want to publish a version of the docs that keeps the "improve this doc" link pointing to mrtk_development branch
      //"_gitContribute": {
      //  "repo": "https://github.com/Microsoft/MixedRealityToolkit-Unity",
      //  "branch": "mrtk_development"
      //}
    },
    "markdownEngineName": "markdig",
    "dest": "doc",
    "xrefService": [ "https://xref.docs.microsoft.com/query?uid={uid}" ] //msdn xref service for resolving crefs
  }
}