[documentation] added few remarks

[kennethrioja]

Summary of changes

• After a PR, I still spotted the line return and it made me think about PR template updated with 'test', 'log' and 'documentation' #1149, and I finally think that what I've written/added in the docs can be useful.

Motivation and context

• see PR template updated with 'test', 'log' and 'documentation' #1149

Checklist

• I have read and followed the CONTRIBUTING guide.
• I confirm that I have the authority necessary to make this contribution on behalf of its copyright owner and agree
  to license it to the TeSS codebase under the
  BSD license.