Add documentation for Out-CurrentFile

Author: daviwil

module/PowerShellEditorServices/Commands/Public/Out-CurrentFile.ps1

@@ -1,13 +1,17 @@
 function Out-CurrentFile {
+    <#
+    .EXTERNALHELP ..\PowerShellEditorServices.Commands-help.xml
+    #>
+    [CmdletBinding()]
     param(
-        [Parameter(ValueFromPipeline)]
-        $data
+        [Parameter(ValueFromPipeline, Mandatory=$true)]
+        $InputObject
     )
 
-    Begin { $d = @() }
-    Process { $d += $data }
+    Begin { $objectsToWrite = @() }
+    Process { $objectsToWrite += $InputObject }
     End {
-        $target = "@`"`r`n{0}`r`n`"@" -f ($d|out-string).Trim()
-        $pseditor.GetEditorContext().currentfile.inserttext($target)
+        $outputString = "@`"`r`n{0}`r`n`"@" -f ($objectsToWrite|out-string).Trim()
+        $psEditor.GetEditorContext().CurrentFile.InsertText($outputString)
     }
-}
+}

module/docs/Out-CurrentFile.md

@@ -0,0 +1,63 @@
+---
+external help file: PowerShellEditorServices.Commands-help.xml
+online version: https://github.com/PowerShell/PowerShellEditorServices/tree/master/module/docs/Out-CurrentFile.md
+schema: 2.0.0
+---
+
+# Out-CurrentFile
+
+## SYNOPSIS
+
+Sends the output through Out-String to the current open editor file.
+
+## SYNTAX
+
+```powershell
+Out-CurrentFile [-InputObject] <Object>
+```
+
+## DESCRIPTION
+
+The Out-CurrentFile cmdlet sends output through Out-String to the current open
+editor file.
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+Get-Process | Out-CurrentFile
+```
+
+Runs the `Get-Process` command and formats its output into the current
+editor file.
+
+## PARAMETERS
+
+### -InputObject
+
+The input object to format, either as a parameter or from the pipeline.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 0
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+## INPUTS
+
+### System.Object
+
+## OUTPUTS
+
+### System.Object
+
+## NOTES
+
+## RELATED LINKS

src/PowerShellEditorServices/Extensions/IEditorOperations.cs

@@ -33,6 +33,10 @@ public interface IEditorOperations
         /// <returns>The resolved file path.</returns>
         string GetWorkspaceRelativePath(string filePath);
 
+        /// <summary>
+        /// Causes a new untitled file to be created in the editor.
+        /// </summary>
+        /// <returns>A task that can be awaited for completion.</returns>
         Task NewFile();
 
         /// <summary>