The publish task Publish_GitHub_Wiki_Content failes due to missing wiki page

[raandree]

Problem description

The publish task Publish_GitHub_Wiki_Content failes due to missing wiki page.

@gaelcolas, can you create just a dummy first wiki page to create the wiki repository?

Verbose logs

Set GitHubConfigUserName to dscbot
Set GitHubConfigUserEmail to [email protected]
	Wiki Output Path              = /home/vsts/work/1/s/output/WikiContent
Publishing Wiki content.
ERROR: Command: git commit --message "Updating Wiki with the content for module version '0.2.0-preview0013'."
git exit code: '1'
git standard output: 'On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean
'
git standard error: ''

At /home/vsts/work/1/s/output/RequiredModules/DscResource.DocGenerator/0.11.2/DscResource.DocGenerator.psm1:2813 char:13
+             throw $throwMessage
+             ~~~~~~~~~~~~~~~~~~~
At /home/vsts/work/1/s/output/RequiredModules/DscResource.DocGenerator/0.11.2/tasks/Publish_GitHub_Wiki_Content.build.ps1:99 char:1
+ task Publish_GitHub_Wiki_Content {
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Build FAILED. 4 tasks, 1 errors, 0 warnings 00:00:32.1189114
Exception: Command: git commit --message "Updating Wiki with the content for module
version '0.2.0-preview0013'." git exit code: '1' git standard output: 'On
branch master Your branch is up to date with 'origin/master'.  nothing to
commit, working tree clean ' git standard error: ''

##[error]PowerShell exited with code '1'.
Finishing: Publish Release

### DSC configuration

```powershell
NA

Suggested solution

Creating a dummy first wiki page solves the issue.

Operating system the target node is running

NA

PowerShell version and build the target node is running

NA

Sampler.DscPipeline version

NA

[gaelcolas]

The wiki is created, so the issue is not there.
I know Johan has worked on this so it may be fixed on a pre-release of DSCResource.DocGenerator..

[johlju]

All changes are currently released. We had this before, and it is due to something is not right in the repo I think. I don't remember why this happened from the top of my head.

[johlju]

Okay, this is because the file Home.md in WikiSource does not have the version tag in the file.

By having v#.#.# in the markdown file the task will update the Home.md (in WikiOutput) on each release. So then there is always something to commit to the GitHb repository. Normally we have the below in the Home.md.

<sup>*SqlServerDsc v#.#.#*</sup>

So the bug is that it should not try to commit if there is no diff.

[raandree]

@johlju, the build is still failing after changing the content of the home.md.

Do we also have to change the already existing content in the wiki that yet does not have a version tag?

[johlju]

In Home.md in WikiSource you need to have the tag v#.#.# somewhere in the document. Then the DocGenerator task will replace that with the actual release semantic version when it saves the Home.md in output/WikiOutput