Synchronize common build scripts and docs template (#258)

Co-authored-by: smaillet <25911635+smaillet@users.noreply.github.com>

Author: smaillet

PsModules/CommonBuild/Public/Get-CurrentBuildKind.ps1

@@ -30,6 +30,9 @@ function Get-CurrentBuildKind
     $currentBuildKind = [BuildKind]::LocalBuild
 
     # IsAutomatedBuild is the top level gate (e.g. if it is false, all the others must be false)
+    # This supports identification of APPVEYOR or GitHub explicitly but also supports the common
+    # `CI` environment variable. Additional build back-ends that don't set the env var therefore,
+    # would need special handling here.
     $isAutomatedBuild = [System.Convert]::ToBoolean($env:CI) `
                         -or [System.Convert]::ToBoolean($env:APPVEYOR) `
                         -or [System.Convert]::ToBoolean($env:GITHUB_ACTIONS)
@@ -40,6 +43,12 @@ function Get-CurrentBuildKind
         # below, so default to a CiBuild (e.g. not a PR, And not a RELEASE)
         $currentBuildKind = [BuildKind]::CiBuild
 
+        # Based on back-end type - determine if this is a release or CI build
+        # The assumption here is that a TAG is pushed to the repo for releases
+        # and therefore that is what distinguishes a release build. Other conditions
+        # would need to use other criteria to determine a PR buddy build, CI build
+        # and release build.
+
         # IsPullRequestBuild indicates an automated buddy build and should not be trusted
         $isPullRequestBuild = $env:GITHUB_BASE_REF -or $env:APPVEYOR_PULL_REQUEST_NUMBER
 

docfx/templates/Ubiquity/public/main.css

@@ -1,8 +1,9 @@
 @charset "UTF-8";
 
 /*
-Disable display of inherited members. It would be nice if there was a build option to not even generate this noise,
-but sadly, there is none so this disables the final render of such things.
+Disable display of inherited members. It would be nice if there was a build option
+to not even generate this noise, but sadly, there is none so this disables the
+final render of such things.
 */
 .typelist.inheritedMembers {
     display: none
@@ -12,6 +13,15 @@ but sadly, there is none so this disables the final render of such things.
     background-color: white
 }
 
+ /*
+ For reasons, unknown style sets this to 100% which forces all tables to the available width.
+ That makes for rather ugly tables and surprising results as the editor doesn't do that for
+ it's preview mode.
+ */
+.table {
+    width: auto
+}
+
 /*
 Customized Highlight JS theming
 The default theming that comes with docfx 'modern' support is rather limited. It doesn't