First public release

Updated version number and some documentation

DeploySSRSTask/task.json

@@ -17,19 +17,19 @@
 	"version": {
 		"Major": "0",
 		"Minor": "2",
-		"Patch": "3"
+		"Patch": "4"
 	},
 	"minimumAgentVersion": "1.95.0",
 	"instanceNameFormat": "SSRS Deploy of project $(Project)",
 	"groups": [],
 	"inputs": [
     {
-      "name": "Project",
+      "name": "Project, Solution or Folder",
       "type": "filePath",
       "label": "Project",
       "required": true,
       "defaultValue": "",
-      "helpMarkDown": "Provide the .rptproj file containing the project to be deployed."
+      "helpMarkDown": "Provide the .rptproj file containing the project to be deployed\nProvide the .sln file if you have a solution to deploy\nProvide a folder to be searched for report projects."
     },
     {
       "name": "Configuration",
@@ -100,7 +100,7 @@
       "label": "Create subfolder if multiple reports",
       "defaultValue": "true",
       "required": true,
-      "helpMarkDown": "If checked a subfolder will be created for this project if it contains more than 1 report file (*.rdl). If only one report file is found no subfolder will be created. The name of the  subfolder will be the same as the name of the reporting project."
+      "helpMarkDown": "If checked a subfolder will be created for deployed projects if they contain more than 1 report file (*.rdl). If only one report file is found no subfolder will be created. The name of the  subfolder will be the same as the name of the reporting project. This will be done on a per project base."
     }],
 	"execution": {
 		"PowerShell3": {

README.md

@@ -4,22 +4,28 @@
 ## Description
 > One or more Visual Studio projects from a solution, a project file or a complete folder, are deployed to a SQL Server Reporting Server Instance. 
 > Supply a .rptproj file, a .sln file or a folder containing all your .rptproj files 
-> Folder will be searched for reports recursivly
 
-
-## Documentation
-> To be implemented
-
-
-### How to Setup build
-> To be implemented
+### How to Setup deploy
+> Make sure you've added the source of your project to a build artifact and that this build artifact is linked to your release definition
+> Note: Report projects do not require Build steps, what happens during a Visual Studio build is nothing more than a copy step of your sources to the build folder
+> Point the "Project, Solution or Folder" entry to the project you are going to deploy. If you specify a folder, all report projects underneath that folder will be searched 
+> for report projects.
+> Note: make sure there is only one report project in your solution. Multiple report projects seem to cause an error during deployment. Multiple reports per project are no problem ofcourse.
+> Use the Overwrtie project Config checkbox to supply the target server parameters. 
+> Server URL requires the service url, usually this is: https://<computername>/reportserver
+> When Overwrite Datasources and Overwrite Datasets are checked changes will be commited to the destination environment. Unckecking makes sure that once the datasource is setup on the target server
+> it will not be overwritten by a new deployment. New datasources will however be added to the server when applicable
+> "Create subfolders if multiple reports" has a special function: all reports will be stored in the Target folder, but when this checkbox is checked the deplyoment component will check if multiple 
+> reports exist inside the project. In this case it will create a subfolder inside the target folder with the name of the project. All reports in this project will be stored in this new folder.
+> This is done on a project base.
 
 ## Contribute
 > * Contributions are welcome!
 > * Submit bugs and help verify fixes
+> [File an issue](https://github.com/avdbrink/VSTS-SSRS-Extention/issues)
 
 ## Latest Updates
 > * None so far
 
 ## TODO:
-> * a Lot!
+> * multiple report projects in a single solution cause an error during deployment