Add docs/samples

Author: YegorStepanov

docs/articles/configs/hidecolumns.md

@@ -0,0 +1,16 @@
+---
+uid: docs.hidingcolumns
+name: Hide columns
+---
+
+# Hiding Columns
+
+You can hide columns in a table in the following ways:
+
+---
+
+[!include[IntroHideColumnsAttr](../samples/IntroHideColumnsAttr.md)]
+
+[!include[IntroHideColumnsConfig](../samples/IntroHideColumnsConfig.md)]
+
+[!include[IntroHideColumnsCustomRule](../samples/IntroHideColumnsCustomRule.md)]

docs/articles/configs/toc.yml

@@ -21,4 +21,6 @@
 - name: Orderers
   href: orderers.md
 - name: ConfigOptions
-  href: configoptions.md
+  href: configoptions.md
+- name: Hiding Columns
+  href: hidingcolumns.md

docs/articles/samples/IntroHideColumnsAttr.md

@@ -0,0 +1,16 @@
+---
+uid: BenchmarkDotNet.Samples.IntroHideColumnsAttr
+---
+
+## Sample: IntroHideColumnsAttr
+
+### Source code
+
+[!code-csharp[IntroHideColumnsAttr.cs](../../../samples/BenchmarkDotNet.Samples/IntroHideColumnsAttr.cs)]
+
+### Links
+
+* @docs.hidingcolumns
+* The permanent link to this sample: @BenchmarkDotNet.Samples.IntroHideColumnsAttr
+
+---

docs/articles/samples/IntroHideColumnsConfig.md

@@ -0,0 +1,16 @@
+---
+uid: BenchmarkDotNet.Samples.IntroHideColumnsConfig
+---
+
+## Sample: IntroHideColumnsConfig
+
+### Source code
+
+[!code-csharp[IntroHideColumnsConfig.cs](../../../samples/BenchmarkDotNet.Samples/IntroHideColumnsConfig.cs)]
+
+### Links
+
+* @docs.hidingcolumns
+* The permanent link to this sample: @BenchmarkDotNet.Samples.IntroHideColumnsConfig
+
+---

docs/articles/samples/IntroHideColumnsCustomRule.md

@@ -0,0 +1,16 @@
+---
+uid: BenchmarkDotNet.Samples.IntroHideColumnsCustomRule
+---
+
+## Sample: IntroHideColumnsCustomRule
+
+### Source code
+
+[!code-csharp[IntroHideColumnsCustomRule.cs](../../../samples/BenchmarkDotNet.Samples/IntroHideColumnsCustomRule.cs)]
+
+### Links
+
+* @docs.hidingcolumns
+* The permanent link to this sample: @BenchmarkDotNet.Samples.IntroHideColumnsCustomRule
+
+---

docs/articles/samples/toc.yml

@@ -54,6 +54,12 @@
   href: IntroGenericTypeArguments.md
 - name: IntroHardwareCounters
   href: IntroHardwareCounters.md
+- name: IntroHideColumnsAttr
+  href: IntroHideColumnsAttr.md
+- name: IntroHideColumnsConfig
+  href: IntroHideColumnsConfig.md
+- name: IntroHideColumnsCustomRule
+  href: IntroHideColumnsCustomRule.md
 - name: IntroInliningDiagnoser
   href: IntroInliningDiagnoser.md
 - name: IntroInProcess

samples/BenchmarkDotNet.Samples/IntroHideColumnsAttr.cs

@@ -0,0 +1,15 @@
+using BenchmarkDotNet.Attributes;
+using BenchmarkDotNet.Rules;
+
+namespace BenchmarkDotNet.Samples
+{
+    [HideColumns(Column.Mean, Column.Error)]
+    [HideColumns("StdDev", "N")]
+    public class IntroHideColumns
+    {
+        [Params(1, 2)] public int N;
+
+        [Benchmark]
+        public void Test() { }
+    }
+}

samples/BenchmarkDotNet.Samples/IntroHideColumnsConfig.cs

@@ -0,0 +1,27 @@
+using BenchmarkDotNet.Attributes;
+using BenchmarkDotNet.Columns;
+using BenchmarkDotNet.Configs;
+using BenchmarkDotNet.Rules;
+using BenchmarkDotNet.Running;
+
+namespace BenchmarkDotNet.Samples
+{
+    public class IntroHideColumnsFluentConfig
+    {
+        public static void Run()
+        {
+            BenchmarkRunner.Run<Benchmark>(
+                DefaultConfig.Instance
+                    .HideColumns(Column.Mean, Column.Error)
+                    .HideColumns("StdDev", "N"));
+        }
+
+        public class Benchmark
+        {
+            [Params(1, 2)] public int N;
+
+            [Benchmark]
+            public void Test() { }
+        }
+    }
+}

samples/BenchmarkDotNet.Samples/IntroHideColumnsCustomRule.cs

@@ -0,0 +1,29 @@
+using BenchmarkDotNet.Attributes;
+using BenchmarkDotNet.Columns;
+using BenchmarkDotNet.Configs;
+using BenchmarkDotNet.Rules;
+using BenchmarkDotNet.Running;
+
+namespace BenchmarkDotNet.Samples
+{
+    public class StatisticColumnHidingRule : IColumnHidingRule
+    {
+        public bool NeedToHide(IColumn column) => column.Category == ColumnCategory.Statistics;
+    }
+
+    public class IntroHideColumnsByCustomRule
+    {
+        public static void Run()
+        {
+            BenchmarkRunner.Run<Benchmark>(
+                DefaultConfig.Instance.HideColumns(new StatisticColumnHidingRule()));
+        }
+
+        [AllStatisticsColumn]
+        public class Benchmark
+        {
+            [Benchmark]
+            public void Test() { }
+        }
+    }
+}