Add documentation for template-based naming of tests about docs HOT 5 CLOSED

I've just added the new page - @CharliePoole, would you mind reviewing what I've done?

The new page is: https://github.com/nunit/docs/wiki/Template-Based-Test-Naming

It is linked from TestCaseAttribute and TestCaseData. I just took the second half from the spec page - that was the bit that seemed relevant from a documentation point of view.

Will close this issue after review.

from docs.

Nice! Some specific comments here:

• Although it's covered further down, I think you need something in the first lines that indicates that there is a default naming convention and that use of this facility is optional.

• The description of how we generate the fullname is incorrect. There is no template for the fullname. Rather we simply append the test case name to the class name, separated by a '.' character. If we allowed the fullname and name to vary independently, a number of things would break internally. 😢

Otherwise, looks great to me.

from docs.

Thanks @CharliePoole.

I've edited the first paragraph.

• Can you clarify where the error is with fullname's? I'm assuming you mean that fullname for method isn't always "Equivalent to {n}.{c}.{m} or {C}.{m}"?
• Is the "Standard Name Formats" still accurate, re: truncating the arguments after 40 characters? I have vague memories that we considered moving the truncating functionality to the runners - but I can't remember if anything ever came of that, or find the relevant issues.

Update: Never mind on the last point - I found the PR I was thinking of, and updated! (It was nunit/nunit#1556)

from docs.

Generation fo the fullname is not currently template-based, as is hinted by your example of a template. By default, it looks as if it is generated by the template you list but it really isn't. Where you see the difference is if you change the test name, then the fullname changes as well. There is no way the user can modify how the fullname is created.

from docs.

Thanks Charlie - I made the change. Sorry it took a while, this was the last thing I did before going on holiday!

from docs.