UM documentation changes between vn13.9 and vn14.0 missing on github??

[MichaelWhitall]

Hi folks,

Its just been pointed out to me (in this PR working on porting UMDPs to lfric_apps: MetOffice/lfric_apps#523) that my port to LFRic is missing a section present in the original UMDP. Strangely, it actually seems to be missing on the trunk in the github um_doc repo!

Compare the UMDP 030 hosted on trac:
https://code.metoffice.gov.uk/doc/um/latest/papers/umdp_030.pdf
with the same doc on github:
https://upgraded-adventure-jznrmqp.pages.github.io/papers/umdp_030.pdf

Section 3.3.1: Numerical Application
is there on trac but missing on github.

That section was lodged on the UM trunk between vn13.9 and vn14.0 in this UM ticket:
https://code.metoffice.gov.uk/trac/um/ticket/7403
i.e. just before git migration.

I could quickly fix this myself in the github um_doc repo, but thought I should report this. Is it possible that when the migration of the UMDPs from trac to github was done, vn13.9 of the docs was accidentally copied onto github instead of the head-of-trunk? Could there be other UM doc changes between vn13.9 and vn14.0 that have been accidentally missed from the git migration?

Cheers!
Mike

[Yaswant Pradhan (yaswant)]

Hi MichaelWhitall can you trace your change on GitHub? Your trac ticket reference can be found https://github.com/MetOffice/um_doc/commit/ffc1ae5c4a2d7fc2b84a91cbf3b561a682ce4279

but I can’t obviously see any additional changes for section 3.3.1 (except for its deletion).

Anyway, please open a new issue in um_doc and add the missing bits via a new PR. Thank you.

[MichaelWhitall]

Awesome thanks Yash, OK panic over, I've spotted the cause of my confusion; its actually the UMDPs on trac that are missing my changes; the github ones are fine! So I guess the UMDPs hosted on trac at
https://code.metoffice.gov.uk/doc/um/latest/papers/umdp_030.pdf
were frozen at vn13.9 and never got rebuilt from the source at git_migration tag?

Section 3.3.1 "Numerical Application" was actually deleted by my UM ticket #7403, not added (I replaced that section with new sections 4.3.2 and 4.3.4, further down the doc).

Cheers!
Mike

[Yaswant Pradhan (yaswant)]

I am glad to hear that. Please note that we do not maintain the contents on trac, so I would suggest we move to UMDP hosted on gh-pages instead.

However, should you need to look at an older version, please clone a specific tag from um_doc tags and build it using build_umdoc.py script. (Caveat: an older version of the script may not work correctly with the latex version we have. If that happens, just checkout the builder script from the head of main)