Documentation outdated for screenshots

[phryneas]

Since 3.0.2, the screenshot behaviour seems to have changed in many aspects and the documentation ( https://docs.cypress.io/api/commands/screenshot.html ) does not reflect that yet.

This is mainly caused by #1826, but I guess other changes in #1858 could have some impact, too?

I do not feel comfortable fixing the documentation myself as I am still just evaluating if I want to use cypress at all and have no idea what is really going on there.

[chrisbreiding]

Thanks for pointing this out. I think we overlooked a few things when updating the docs. I'm going to update the screenshot doc and add a section about naming conventions.

[phryneas]

Thanks for getting to this so quickly :)

And I'm really sorry for my sour tone in the other issue - I had been fooled by the old doc for a few hours by that point so I was quite frustrated - not the right mood to comment on an issue :( Hope its okay.

[chrisbreiding]

No worries. I completely understand how frustrating incorrect documentation can be.

[brian-mann]

We noticed a bug in the implementation when capturing screenshots in cypress run and cypress open that is also making this more confusing.