Move 0.6.4.0 to be first in the tabs (so james stop crying for no good reasons)

Added some information for 0.6.x & more notes

Author: Mrcubix

code_and_explain/bindings.md

@@ -1,69 +1,69 @@
 # Bindings
 
 ::::{tabs}
-:::{tab} 0.5.3.3
+:::{tab} 0.6.4.0
 ```csharp
 [PluginName("My Binding")]
-public class MyBinding : IBinding, IValidateBinding
+public class MyBinding : IStateBinding
 {
-    [Property("Property")]
+    [Property("Property"), PropertyValidated(nameof(ValidProperties))]
     public string Property { set; get; } = string.Empty;
 
-    public Action Press
+    public void Press(TabletReference tablet, IDeviceReport report)
     {
-        get => () => {
-            // do something depending on <see cref="Property"/>
-        };
+        // do something depending on <see cref="Key"/>
     }
 
-    public Action Release
+    public void Release(TabletReference tablet, IDeviceReport report)
     {
-        get => () => {
-            // do something depending on <see cref="Property"/>
-        };
+        // do something depending on <see cref="Key"/>
     }
 
     /// <summary>
     /// A list of valid keys for this category
     /// </summary>
-    public string[] ValidProperties => new string[] { "Option 1", "Option 2" };
+    public static IEnumerable<string> ValidProperties => new List<string> { "Option 1", 
+                                                                            "Option 2" };
 
-    public override string ToString() => $"My Binding: {Property}";
+    public override string ToString() => $"My Binding: {Key}";
 }
 ```
 :::
-:::{tab} 0.6.4.0
+:::{tab} 0.5.3.3
 ```csharp
 [PluginName("My Binding")]
-public class MyBinding : IStateBinding
+public class MyBinding : IBinding, IValidateBinding
 {
-    [Property("Key"), PropertyValidated(nameof(ValidKeys))]
-    public string Key { set; get; } = string.Empty;
+    [Property("Property")]
+    public string Property { set; get; } = string.Empty;
 
-    public void Press(TabletReference tablet, IDeviceReport report)
+    public Action Press
     {
-        // do something depending on <see cref="Key"/>
+        get => () => {
+            // do something depending on <see cref="Property"/>
+        };
     }
 
-    public void Release(TabletReference tablet, IDeviceReport report)
+    public Action Release
     {
-        // do something depending on <see cref="Key"/>
+        get => () => {
+            // do something depending on <see cref="Property"/>
+        };
     }
 
     /// <summary>
     /// A list of valid keys for this category
     /// </summary>
-    public static IEnumerable<string> ValidKeys => new List<string> { "Option 1", 
-                                                                      "Option 2" };
+    public string[] ValidProperties => new string[] { "Option 1", "Option 2" };
 
-    public override string ToString() => $"My Binding: {Key}";
+    public override string ToString() => $"My Binding: {Property}";
 }
 ```
 :::
 ::::
 
 Bindings from plugins can only get selected by the user from the Advanced Binding Editor. \
-Any options in the `ValidKeys` array will be displayed in the UI as a dropdown list of 'My Binding'.
+Any options in the `ValidProperties` / `ValidKeys` array will be displayed in the UI as a dropdown list of 'My Binding'.
 
 ```{image} img/bindings-dropdown.png
 :alt: Bindings dropdown

code_and_explain/dependencies.md

@@ -3,27 +3,6 @@
 Your plugin may depend on objects, such as a reference to a tablet using the plugin or an instance of `IDriver`, and more.
 
 ::::{tabs}
-:::{tab} 0.5.3.3
-```csharp
-private IDriver _driverInstance = Info.Driver;
-
-// Equivalent of TabletReference
-private TabletState _tabletState = Info.TabletState;
-
-private ITimer _timer = SystemInterop.Timer;
-
-private IAbsolutePointer _absolutepointer = SystemInterop.AbsolutePointer;
-
-private IRelativePointer _relativePointer = SystemInterop.RelativePointer;
-
-// Linux only
-private IVirtualTablet? _virtualTablet = SystemInterop.VirtualTablet;
-
-private IVirtualScreen _virtualScreen = SystemInterop.VirtualScreen;
-
-private IVirtualKeyboard _virtualKeyboard = SystemInterop.VirtualKeyboard;
-```
-:::
 :::{tab} 0.6.4.0
 ```csharp
 [TabletReference]
@@ -51,8 +30,33 @@ public IVirtualScreen VirtualScreen { get; set; }
 public IVirtualKeyboard VirtualKeyboard { get; set; }
 ```
 :::
+:::{tab} 0.5.3.3
+```csharp
+private IDriver _driverInstance = Info.Driver;
+
+// Equivalent of TabletReference
+private TabletState _tabletState = Info.TabletState;
+
+private ITimer _timer = SystemInterop.Timer;
+
+private IAbsolutePointer _absolutepointer = SystemInterop.AbsolutePointer;
+
+private IRelativePointer _relativePointer = SystemInterop.RelativePointer;
+
+// Linux only
+private IVirtualTablet? _virtualTablet = SystemInterop.VirtualTablet;
+
+private IVirtualScreen _virtualScreen = SystemInterop.VirtualScreen;
+
+private IVirtualKeyboard _virtualKeyboard = SystemInterop.VirtualKeyboard;
+```
+:::
 ::::
 
 ```{admonition} Developing for 0.5.x
-`SystemInterop` is part of the `OpenTabletDriver.Desktop.Interop` namespace;
+`SystemInterop` is part of the `OpenTabletDriver.Desktop.Interop` namespace.
+```
+
+```{admonition} Developing for 0.6.x
+`SystemInterop` is now `DesktopInterop`, and is still part of the `OpenTabletDriver.Desktop.Interop` namespace.
 ```

code_and_explain/filters.md

@@ -1,21 +1,6 @@
 # Filters
 
 ::::{tabs}
-:::{tab} 0.5.3.3
-```csharp
-[PluginName("My Name")]
-public class MyFilter : IFilter
-{
-    public FilterStage FilterStage => FilterStage.PreTranspose;
-
-    // Position is received here
-    public Vector2 Filter(Vector2 value)
-    {
-        return value;
-    }
-}
-```
-:::
 :::{tab} 0.6.4.0
 ```csharp
 [PluginName("My Name")]
@@ -34,13 +19,34 @@ public class MyFilter : IPositionedPipelineElement<IDeviceReport>
 }
 ```
 :::
+:::{tab} 0.5.3.3
+```csharp
+[PluginName("My Name")]
+public class MyFilter : IFilter
+{
+    public FilterStage FilterStage => FilterStage.PreTranspose;
+
+    // Position is received here
+    public Vector2 Filter(Vector2 value)
+    {
+        return value;
+    }
+}
+```
+:::
 ::::
 
-In 0.5.3.3, you are able to alter positionnal reports via the `Filter` method, which is called on every report. \
-You may cancel the report by returning `Vector2.Zero` or less if the user has `Ignore output outside area` is enabled.
+In 0.6.x, You are able to alter positionnal reports via the `Consume()` method, which is called on every report. \
+You can also choose to not emit a positionnal report to prevent it from going further in the pipeline.
+
+In 0.5.x, you are able to alter positionnal reports via the `Filter` method, which is called on every report. \
+You may discard the report by returning `Vector2.Zero` or less if the user has `Ignore output outside area` is enabled.
 
 Filters can choose to be called at two different stages of the pipeline by changing the value of `Position`. \
-The possible values are : `FilterStage.PreTranspose` and `FilterStage.PostTranspose` \
+The possible values are :
+- Before the transformation: `PipelinePosition.PreTransform` (0.6.x) / `FilterStage.PreTranspose` (0.5.x),
+- After the transformation: `PipelinePosition.PostTransform` (0.6.x) / `FilterStage.PostTranspose` (0.5.x)
+
 (before or after the transformation from tablet to screen coordinates).
 
 ```{admonition} Do not block non-handled input types (0.6.x Only)

code_and_explain/interpolators.md

@@ -1,35 +1,11 @@
 # Interpolators
 
 ```{admonition} Help Wanted
-:class: error
+:class: danger
 This section is incomplete. If you have experience with OpenTabletDriver's interpolators, please consider contributing to this documentation.
 ```
 
 ::::{tabs}
-:::{tab} 0.5.3.3
-```csharp
-[PluginName("My Name")]
-public class MyInterp : Interpolator
-{
-    private SyntheticTabletReport syntheticReport;
-
-    public MyInterp(ITimer scheduler) : base(scheduler)
-    {
-    }
-
-    // Position is received here
-    public override SyntheticTabletReport Interpolate()
-    {
-        return syntheticReport;
-    }
-
-    public override void UpdateState(SyntheticTabletReport report)
-    {
-        syntheticReport = new SyntheticTabletReport(report);
-    }
-}
-```
-:::
 :::{tab} 0.6.4.0
 ```csharp
 [PluginName("My Name")]
@@ -67,16 +43,33 @@ public class MyInterp : AsyncPositionedPipelineElement<IDeviceReport>
 }
 ```
 :::
-::::
+:::{tab} 0.5.3.3
+```csharp
+[PluginName("My Name")]
+public class MyInterp : Interpolator
+{
+    private SyntheticTabletReport syntheticReport;
 
-The `UpdateState` in called on every tablet reports, while `Interpolate` is called at the frequency defined by the user, represented by the `Frequency` property.
+    public MyInterp(ITimer scheduler) : base(scheduler)
+    {
+    }
 
-```{admonition} Do not block non-handled input types (0.6.x Only)
-:class: danger
-Plugins such as Interpolators should emit non-handled report types in `ConsumeState()`.  
-Failing in doing so may result in those reports being discarded.  
-(Preventing Bindings set by the user from being invoked & other plugins from working properly)
+    // Position is received here
+    public override SyntheticTabletReport Interpolate()
+    {
+        return syntheticReport;
+    }
+
+    public override void UpdateState(SyntheticTabletReport report)
+    {
+        syntheticReport = new SyntheticTabletReport(report);
+    }
+}
 ```
+:::
+::::
+
+The `UpdateState` in called on every tablet reports, while `Interpolate` is called at the frequency defined by the user, represented by the `Frequency` property.
 
 ```{admonition} Confusing changes were made in 0.6.x
 :class: warning
@@ -85,6 +78,13 @@ The `UpdateState` method is instead called at the frequency defined by the user
 Keep this in mind if you make an interpolator in 0.5.x & want to make it work properly in 0.6.x.
 ```
 
+```{admonition} Do not block non-handled input types (0.6.x Only)
+:class: danger
+Plugins such as Interpolators should emit non-handled report types in `ConsumeState()`.  
+Failing in doing so may result in those reports being discarded.  
+(Preventing Bindings set by the user from being invoked & other plugins from working properly)
+```
+
 You can make your interpolator configurable by the user by adding properties to your class.
 
 ```csharp