publish tests and coverage correctly

Docs/articles/toc.yml

@@ -1,16 +1,25 @@
-- name: MLEM.Ui
+- name: MLEM
-  href: ui.md
 - name: Font Extensions
   href: font_extensions.md
 - name: Text Formatting
   href: text_formatting.md
 - name: Input Handler
   href: input.md
-- name: Raw Content Manager
-  href: raw_content.md
 - name: Sprite Animations
   href: sprite_animations.md
+
+- name: MLEM.Ui
+- name: MLEM.Ui
+  href: ui.md
+
+- name: MLEM.Extended
 - name: Tiled Extensions
   href: tiled_extensions.md
+
+- name: MLEM.Data
+- name: Raw Content Manager
+  href: raw_content.md
+
+- name: MLEM.Startup
 - name: MLEM.Startup
   href: startup.md

Jenkinsfile

@@ -1,31 +1,38 @@
 pipeline {
-  agent any
+  agent none
   stages {
-    stage('Submodules') {
+    stage('Cake') {
-      steps {
+      agent any
-        sh 'git submodule update --init --recursive --force'
+      stages {
+        stage('Submodules') {
+          steps {
+            sh 'git submodule update --init --recursive --force'
+          }
+        }
+        stage('Build') {
+          steps {
+            sh 'dotnet tool restore'
+            // we use xvfb to allow for graphics-dependent tests
+            sh 'xvfb-run -a dotnet cake --target Publish --branch ' + env.BRANCH_NAME
+          }
+        }
+        stage('Document') {
+          steps {
+            sh 'dotnet cake --target Document --branch ' + env.BRANCH_NAME
+            stash includes: 'Docs/_site/**', name: 'site'
+          }
+        }
       }
-    }
+      post {
-    stage('Cake Build') {
+        always {
-      steps {
+          nunit testResultsPattern: '**/TestResults.xml'
-        sh 'dotnet tool restore'
+          cobertura coberturaReportFile: '**/coverage.cobertura.xml'
-        // we use xvfb to allow for graphics-dependent tests
+        }
-        sh 'xvfb-run -a dotnet cake --target Publish --branch ' + env.BRANCH_NAME
-      }
-    }
-    stage('Document') {
-      steps {
-        sh 'dotnet cake --target Document --branch ' + env.BRANCH_NAME
-        stash includes: 'Docs/_site/**', name: 'site'
       }
     }
     stage('Publish Docs') {
-      agent {
+      agent { label 'web' }
-          label 'web'
+      when { branch 'release' }
-      }
-      when {
-        branch 'release'
-      }
       steps {
         unstash 'site'
         sh 'rm -rf /var/www/MLEM/*'
@@ -33,12 +40,6 @@ pipeline {
       }
     }
   }
-  post {
-    always {
-      nunit testResultsPattern: '**/TestResults.xml'
-      cobertura coberturaReportFile: '**/coverage.cobertura.xml'
-    }
-  }
   environment {
     BAGET = credentials('3db850d0-e6b5-43d5-b607-d180f4eab676')
     NUGET = credentials('e1bf7f6c-6047-4f7e-b639-15240a8f8351')

MLEM.Data/RuntimeTexturePacker.cs

@@ -49,7 +49,7 @@ namespace MLEM.Data {
         /// Creates a new runtime texture packer with the given settings.
         /// </summary>
         /// <param name="maxWidth">The maximum width that the packed texture can have. Defaults to 2048.</param>
-        /// <param name="autoIncreaseMaxWidth">Whether the maximum width should be increased if there is a texture to be packed that is wider than <see cref="maxWidth"/>. Defaults to false.</param>
+        /// <param name="autoIncreaseMaxWidth">Whether the maximum width should be increased if there is a texture to be packed that is wider than the maximum width specified in the constructor. Defaults to false.</param>
         /// <param name="forcePowerOfTwo">Whether the resulting <see cref="PackedTexture"/> should have a width and height that is a power of two.</param>
         /// <param name="forceSquare">Whether the resulting <see cref="PackedTexture"/> should be square regardless of required size.</param>
         /// <param name="disposeTextures">Whether the original textures submitted to this texture packer should be disposed after packing.</param>

MLEM.Extended/Tiled/IndividualTiledMapRenderer.cs

@@ -190,7 +190,7 @@ namespace MLEM.Extended.Tiled {
         }
 
         /// <summary>
-        /// A delegate method used for <see cref="IndividualTiledMapRenderer.depthFunction"/>.
+        /// A delegate method used for an <see cref="IndividualTiledMapRenderer"/>'s depth function.
         /// The idea is to return a depth (between 0 and 1) for the given tile that determines where in the sprite batch it should be rendererd.
         /// Note that, for this depth function to take effect, the sprite batch needs to begin with <see cref="SpriteSortMode.FrontToBack"/> or <see cref="SpriteSortMode.BackToFront"/>.
         /// </summary>

MLEM.Ui/Elements/Button.cs

@@ -76,7 +76,7 @@ namespace MLEM.Ui.Elements {
         public bool CanSelectDisabled;
         /// <summary>
         /// An optional function that can be used to modify the result of <see cref="IsDisabled"/> automatically based on a user-defined condition. This removes the need to disable a button based on a condition in <see cref="Element.OnUpdated"/> or manually.
-        /// Note that, if <see cref="IsDisabled"/>'s underlying value is set to <see langword="true"/> using <see cref="set_IsDisabled"/>, this function's result will be ignored.
+        /// Note that, if <see cref="IsDisabled"/>'s underlying value is set to <see langword="true"/> using <see cref="IsDisabled"/>, this function's result will be ignored.
         /// </summary>
         public Func<Button, bool> AutoDisableCondition;
 

MLEM.Ui/Elements/Panel.cs

@@ -13,13 +13,13 @@ namespace MLEM.Ui.Elements {
     /// <summary>
     /// A panel element to be used inside of a <see cref="UiSystem"/>.
     /// The panel is a complex element that displays a box as a background to all of its child elements.
-    /// Additionally, a panel can be set to <see cref="scrollOverflow"/> on construction, which causes all elements that don't fit into the panel to be hidden until scrolled to using a <see cref="ScrollBar"/>.
+    /// Additionally, a panel can be set to scroll overflowing elements on construction, which causes all elements that don't fit into the panel to be hidden until scrolled to using a <see cref="ScrollBar"/>.
     /// </summary>
     public class Panel : Element {
 
         /// <summary>
         /// The scroll bar that this panel contains.
-        /// This is only nonnull if <see cref="scrollOverflow"/> is true.
+        /// This is only nonnull if scrolling overflow was enabled in the constructor.
         /// Note that some scroll bar styling is controlled by this panel, namely <see cref="StepPerScroll"/> and <see cref="ScrollerSize"/>.
         /// </summary>
         public readonly ScrollBar ScrollBar;

MLEM.Ui/Elements/ProgressBar.cs

@@ -10,7 +10,7 @@ using MLEM.Ui.Style;
 namespace MLEM.Ui.Elements {
     /// <summary>
     /// A progress bar element to use inside of a <see cref="UiSystem"/>.
-    /// A progress bar is an element that fills up a bar based on a given <see cref="currentValue"/> percentage.
+    /// A progress bar is an element that fills up a bar based on a given <see cref="CurrentValue"/> percentage.
     /// </summary>
     public class ProgressBar : Element {
 

MLEM.Ui/Elements/Tooltip.cs

@@ -196,7 +196,7 @@ namespace MLEM.Ui.Elements {
         }
 
         /// <summary>
-        /// Causes this tooltip's position to be snapped to the mouse position, or the <see cref="snapElement"/> if <see cref="DisplayInAutoNavMode"/> is true, or the <see cref="SnapPosition"/> if set.
+        /// Causes this tooltip's position to be snapped to the mouse position, or the element to snap to if <see cref="DisplayInAutoNavMode"/> is true, or the <see cref="SnapPosition"/> if set.
         /// </summary>
         public void SnapPositionToMouse() {
             Vector2 snapPosition;

MLEM/Cameras/Camera.cs

@@ -13,7 +13,7 @@ namespace MLEM.Cameras {
 
         /// <summary>
         /// This field holds an epsilon value used in some camera calculations to mitigate floating point rounding inaccuracies.
-        /// If camera <see cref="Position"/> or <see cref="Viewport"/> size are extremely small or extremely big, this value can be reduced or increased.
+        /// If camera <see cref="Position"/> or <see cref="ScaledViewport"/> size are extremely small or extremely big, this value can be reduced or increased.
         /// </summary>
         public static float Epsilon = 0.01F;
 

MLEM/Input/GenericInput.cs

@@ -32,7 +32,7 @@ namespace MLEM.Input {
         public static readonly GenericInput[] AllInputs = GenericInput.AllKeys.Concat(GenericInput.AllMouseButtons).Concat(GenericInput.AllButtons).ToArray();
 
         /// <summary>
-        /// The <see cref="InputType"/> of this generic input's current <see cref="value"/>.
+        /// The <see cref="InputType"/> of this generic input's current value.
         /// </summary>
         [DataMember]
         public readonly InputType Type;

build.cake

@@ -1,5 +1,5 @@
 #addin nuget:?package=Cake.DocFx&version=1.0.0
-#tool dotnet:?package=docfx&version=2.63.0
+#tool dotnet:?package=docfx&version=2.65.3
 
 // this is the upcoming version, for prereleases
 var version = Argument("version", "6.2.0");