gl-vsts-tasks-file-patch icon indicating copy to clipboard operation
gl-vsts-tasks-file-patch copied to clipboard

Add more documentation examples for the various supported languages

Open Mertsch opened this issue 9 years ago • 1 comments

This issue is related to the comment on https://marketplace.visualstudio.com/items?itemName=geeklearningio.gl-vsts-tasks-file-patch&showReviewDialog=true

May we ask a bit more details about the struggle with XML patch so we can improve our documentation accordingly? Is it related to XPath syntax or was it something else?

What I mean is that this page https://github.com/geeklearningio/gl-vsts-tasks-file-patch/wiki/How-to-use-Slick-Syntax is great as it shows a very simple, yet enough example to get started.

while this page https://github.com/geeklearningio/gl-vsts-tasks-file-patch/wiki/Patch-XML-Files contains no examples at all (taking into account the slick syntax is already covered)

I wish there was a similar example as with the slick syntax for the full syntax. I would not expect you to explain XPath, as this is pretty well documented. Just maybe have a link to an examples page like this great resource https://tools.ietf.org/html/rfc5261#appendix-A

Also it may sound strange, but I did not notice the "Syntax Type" combobox at the top at all and wondered why my slick syntax isn't accepted maybe it can be placed closer to the actual syntax box.

Mertsch avatar Oct 31 '16 09:10 Mertsch

I did not follow up, but this is definitely great feedback and we plan on improving those documentations soon.

sandorfr avatar Dec 13 '16 23:12 sandorfr