Logging docs to be added

[jamoore]

See: ​https://github.com/openmicroscopy/ome-documentation/pull/396

• --debug, --report, --email, and --upload from the CLI
• tracing and warning settings
• zipping logs for feedback
• rollback the removal of the logback.xml link from the same PR (​commit)

[hflynn]

Should this ticket actually be done for 5.0 given the work that has been done on logging?

[jamoore]

Parts will certainly make sense. We can split up once we start focusing on 5.0.1

[hflynn]

If further work is required, perhaps @cblackburn or someone else can take ownership of this ticket and make the necessary changes for 5.0.1.

[jburel]

Passing it to Colin so he can have a first go at it.

[cblackburn]

I'm moving this to 5.0.2 for now as I'm not sure of the full extent of the changes and additions required.

[cblackburn]

Re-reading this 19 months later I'm even less certain of what's actually required, especially as this was originally targeted at 5.0.1

[jamoore]

Guess it's largely due to ​https://github.com/openmicroscopy/ome-documentation/pull/396/files#diff-f575e251489228bcf7f58333f161e9bbL83 but perhaps that's been taken care of elsewhere. Seb?

[sbesson]

The CLI options to report feedback should have been covered via ​https://github.com/openmicroscopy/ome-documentation/pull/1152 and are now published at http://www.openmicroscopy.org/site/support/omero5.1/users/cli/import.html. Note sure if there is any concrete plan for the content of the other two items removed from the list in the previous link.

[hflynn]

CLI options added by Seb as mentioned, and ​https://www.openmicroscopy.org/site/support/omero5.1/developers/logging.html contains a link to logback.xml and a note that you can compress log files by zipping them. So the only thing I'm not clear on is whether we've got 'tracing and warning settings' covered anywhere.

[jamoore]

I'll assume this is all more-than-covered by our existing "logging" cards.