add Core + build script

Author: tocsoft

.gitmodules

@@ -10,3 +10,6 @@
 [submodule "ext/Shapes"]
 	path = ext/Shapes
 	url = https://github.com/SixLabors/Shapes.git
+[submodule "ext/Core"]
+	path = ext/Core
+	url = https://github.com/SixLabors/Core.git

README.md

@@ -7,12 +7,12 @@ latest [docfx](https://dotnet.github.io/docfx/) version needs to be installed. *
 ### How to update
 To pull in the latest source of a project you have to navigate into the `ext` folder and checkout the required revision (by default these should always be pointing to the latest tagged full release)
 
-### How build
-run `docfx` from the command line. This will regenerate the site in the `docs` folder.
+### How do I build the latest docs
+run `build.cmd`/`build.ps1` from the command line. This will checkout that latest tagged commits for each of the repositories and regenerates the site in the `docs` folder.
 
 ### How to preview
-run `docfx --serve` this rebuilds the site but also runs a dev server at [http://localhost:8080](http://localhost:8080) so you can preview the current state of the docs.
+run `serve.cmd`/`serve.ps1` this rebuilds the site but also runs a dev server at [http://localhost:8080](http://localhost:8080) so you can preview the current state of the docs.
 
 ### Updating the docs
 
-to be confirmed
+To make changes make sure you rebuild (run `build.cmd`) before committing. *TODO: automate this as a build step.*

api/toc.md

@@ -1,4 +1,5 @@
 # @SixLabors.ImageSharp
 # @SixLabors.ImageSharp.Web
 # @SixLabors.Fonts
-# @SixLabors.Shapes
+# @SixLabors.Shapes
+# @SixLabors.Primitives

build.cmd

@@ -0,0 +1,17 @@
+@echo Off
+
+PowerShell -NoProfile -ExecutionPolicy Bypass -Command "& '.\build.ps1'"
+
+if not "%errorlevel%"=="0" goto failure
+
+:success
+ECHO successfully built project
+REM exit 0
+goto end
+
+:failure
+ECHO failed to build.
+REM exit -1
+goto end
+
+:end

build.ps1

@@ -0,0 +1,14 @@
+# ensure all submodules are currently checked out to the latest tag
+git submodule update --init
+Get-ChildItem ./ext -Directory | ForEach-Object {
+    $path = $_.FullName
+
+    git -C "$path" fetch
+    $lastTag = (git -C "$path" describe --abbrev=0 --tags )  | Out-String
+    $lastTag = $lastTag.Trim()
+
+    Write-Host "$path => $lastTag"
+    git -C "$path" reset --hard "$lastTag" --
+}
+
+docfx

docfx.json

@@ -75,6 +75,25 @@
       "properties": {
         "TargetFramework": "netstandard2.0"
       }
+    },
+    {
+      "src": [
+        {
+          "files": [
+            "ext/Core/src/**.csproj"
+          ],
+          "exclude": [
+            "**/obj/**",
+            "**/bin/**",
+            "docs/**"
+          ]
+        }
+      ],
+      "dest": "api/Core",
+      "disableGitFeatures": false,
+      "properties": {
+        "TargetFramework": "netstandard2.0"
+      }
     }
   ],
   "build": {