Document the TOTAL_STATS format

[kinow]

I remember talking with @dbeltrankyl some time about it, and I think we wrote it somewhere (in a ClimateDT deliverable?), but not in our Sphinx docs, as I couldn't find anything searching it.

This issue was requested by @lauherrero.

Linked issues, created whilst reviewing the existing code: #2061 #2060

[dbeltrankyl]

The fields are

ready , submit, start , finish, (COMPLETED/FAILED)

[kinow]

The example TOTAL_STATS:

20250107000024
20250107000024
20250107124214
20250107124214 20250107124214 20250107124217 FAILED 20250107124214 20250107235624 COMPLETED

AS version: 4.0.98 (expid a82m, hubs/esarchive).

[kinow]

From discussion in the meeting this morning: @lauherrero 's version was hard to parse/comprehend, because this older version of AS had a bug and writes the TOTAL_STATS incorrectly.

@lauherrero for now the best fix for this issue would be to just wait for 4.1.x Autosubmit to be deployed to the hubs. Then the TOTAL_STATS file will be fixed. I will leave this issue open anyway as we must document it for users & other devs 👍

[lauherrero]

Thanks :)