Add more detail to commands.md documentation

The documentation located at https://github.com/Microsoft/vsts-tasks/blob/master/docs/authoring/commands.md needs more detail added to it, here are some things that I am still unsure of after trying to puzzle it out for a while

All the issues I have found mainly have been with the documentation of ##vso[task.logdetail]

• Does parentid need to be passed with every request or is it a write once field like name or order?
• What format should time be in for starttime and finishtime? If it is a format without timezone should it be local time or UTC?
• What format should the GUIDs be in?
• What should we be putting in for type? The two examples that you show use build as the value passed in, should we always pass in build or are there other valid values?
• What format does progress need to be in, can it accept decimals, can it accept commas?
• Is there well defined behavior when two objects have the same value for order?
• Examples are not actual examples: ##vso[task.logdetail id=new guid;name=project1;type=build;order=1]create new timeline record. would fail because id=new guid is not a valid value.

[chwarr]

This issue still exists as more-or-less as originally reported. It should not be marked as stale. The next action needs to be taken by the Azure Pipelines Task team to clarify the format and semantics here. This is not something that we, the users of Azure Pipelines, can definitively answer ourselves.

[d3r3kk]

I don’t see any sort of sub-timeline information anywhere in the latest version of the Build output UX.

In the newest UX for builds, where does the output of logdetail go? Is this even relevant information any longer?