OBPIH-6197 Update documentation for official 0.9.x release #4771
OBPIH-6197 Update documentation for official 0.9.x release #4771
Conversation
… to navigation; fixed outdated docs; added dark mode toggle (#4235)
…features; added quickstart guides;
…raft docs (OBPIH-6200)
…ort advanced features and extensions; moved images to assets directory
…ckstart, upgrading, onboarding); improved features page
| # Known Issues | ||
|
|
||
| * GitHub > MySQL 8 issues | ||
| * https://pihemr.atlassian.net/browse/OBS-1609 |
There was a problem hiding this comment.
These links won't be available for people outside PIH Jira
There was a problem hiding this comment.
yeah these links were more of a placeholder to remind me to pull out information from the ticket. but i'm just going to comment them out for now.
|
|
||
| Use the latest Configuration Guide to configure your server(s). | ||
|
|
||
| ### Migrate Database |
There was a problem hiding this comment.
what about any data that was inserted since the backup was taken? Not much point to making it rolling deployable if everything done during the deployment is lost. Maybe I'm misunderstanding though
There was a problem hiding this comment.
we talked about this over slack. I was assuming this "parallel" option meant rolling deploy / no downtime deploy. Really it just means installing a new instance in parallel then migrating over when you're ready.
There was a problem hiding this comment.
I think what's throwing things off for me is the "Switch Over" step is glossing over quite a lot. I think what you're suggesting is taking two backups: One at the start of the process that we can upload to the new 0.9.x instance whenever we're ready to test the instance, and then a second backup while actually switching over to the new instance while the old instance is down to capture any new data that was added since then.
So we'd want the "Disable Production Environment" step to be before we do the second backup (not sure if you're still writing all this out).
There was a problem hiding this comment.
to the point about "parallel" vs "in-place" migration, i am using those terms because those were the most common. however i still don't like "parallel" as it causes confusion. my first attempt at this was "clean slate" vs "in place", which i don't like because "clean slate" carries a conotation that is not true (i.e. we're starting fresh, including the database). but now i'm also seeing that "side-by-side" is also used to describe "parallel" migrations, so i might use that breakdown instead.
There was a problem hiding this comment.
regarding the "switch over" part, i'll just say that in general there's a lot missing so i might need some help structuring the missing buckets and maybe even writing some of these sections because my brain is mush after working on this for so long.
…sing; fixed typo with certbot url
…de; added glossary; temporarily removed outdated developer guide
Overhaul the upgrade instructions for 0.9.x
OBPIH-6197 update mkdocs kit and related doc
…ues with tomcat9 package
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## develop #4771 +/- ##
============================================
+ Coverage 7.74% 7.78% +0.03%
- Complexity 859 867 +8
============================================
Files 613 613
Lines 42621 42621
Branches 10350 10350
============================================
+ Hits 3303 3320 +17
+ Misses 38825 38806 -19
- Partials 493 495 +2 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
Docs are currently published here
https://docs.openboxes.com/en/obpih-6197/