iodepo / odis-arch

Development of the Ocean Data and Information System (ODIS) architecture
https://book.odis.org/
29 stars 17 forks source link

book melding #328

Open fils opened 1 year ago

fils commented 1 year ago

This is an issue for the updating of the book directory. I have updated the page at:

https://github.com/iodepo/odis-arch/blob/master/archive/docs/bookBuilding.md

with a visual of the proposed branch flows and a sample workflow for us to discuss.

A quick scan of the old and new directory follows at the end to highlight some of the changes that need merged.

I will take a first pass at this with the meld. Since that will make the process easy to do. Once that is done there should be only a few outlier changes to port over. Once I do that I can push the changes and report back in this issue.

Make sure you can build and view the pages locally since that is far more efficient and the online book will only get updated when we merge to the publication branch.

The following simple command highlights some of the files that are different between these two directories. Many of these changes SHOULD NOT be moved over from book to bookRev1 since they are changes to support the new locaiton for the graph. I'll do a first pass at diff'ing these two together before we meet.

❯ diff -rq bookRev1 book --exclude _build | grep -v Only
Files bookRev1/foundation/foundation.md and book/foundation/foundation.md differ
Files bookRev1/index.md and book/index.md differ
Files bookRev1/lib/__pycache__/jbutils.cpython-310.pyc and book/lib/__pycache__/jbutils.cpython-310.pyc differ
Files bookRev1/personas/persona.md and book/personas/persona.md differ
Files bookRev1/publishing/publishing.md and book/publishing/publishing.md differ
Files bookRev1/thematics/dataset/index.md and book/thematics/dataset/index.md differ
Files bookRev1/thematics/docs/maps.md and book/thematics/docs/maps.md differ
Files bookRev1/thematics/events/index.md and book/thematics/events/index.md differ
Files bookRev1/thematics/identifier/id.md and book/thematics/identifier/id.md differ
Files bookRev1/thematics/languages/languages.md and book/thematics/languages/languages.md differ
Files bookRev1/thematics/provenance/id.md and book/thematics/provenance/id.md differ
Files bookRev1/thematics/sdg/index.md and book/thematics/sdg/index.md differ
Files bookRev1/thematics/terms/list.md and book/thematics/terms/list.md differ
Files bookRev1/thematics/variables/index.md and book/thematics/variables/index.md differ
Files bookRev1/_toc.yml and book/_toc.yml differ