Topic on User talk:Harakoni

Jump to navigation Jump to search

Hi Harakoni... Just to let you know that I've started making some checks and corrections to the surgery section and other related pages.

The entire thing seemed to have become a bit confused on the wiki - bits and bobs had been added in different places: some repeating the same thing, some contradicting, some just wrong, as I'm sure you're already aware.

I noticed that:

  • some of the pseudocode on the Doctoring page was incorrect (like outdoors modifiers etc.)
  • the pseudocode itself it was incessantly complicated for a non-developer to understand.
  • The explanations on the Doctoring page mish-mashed the concept of surgical success chance of the doctor, with the type of bed, with the instance of bed.
  • The explanations appeared to get confused with environmental factors such as cleanliness and light level - in fact these affect the bed's surgery success chance multiplier which is a separate stat.
  • The concept that operations have their own individual success modifiers appeared to be missing completely.
  • The concept that facilities such as vitals scanner could modify outcome probabilities wasn't mentioned.
  • The concept of lighting was alluded to, but contradictory and not complete.
  • Generally the nomenclature "surgery" and "operation" seemed to be inconsistent across the Doctoring page; the entire wiki, and references back to the Doctoring page. It's quite confusing from a new reader's standpoint as they sound like two different things. It's admittedly a bit inconsistent in the game itself especially the descriptions - but one thing is clear, that the action on the colonist is an "operation".

So what I've done is:

  • Simplified the pseudocode into simple, worded equations like you'd see on wikipedia - no mathematical symbols, variables or logical control statements (viz. "if"s).
  • Broken up the different concepts onto their respective pages: Colonist Medical surgery success chance/Doctoring, Bed Surgery Success Chance Factor, medicine potency and operation chance multiplier.
  • Broken up the concept between the type of bed and the placement of a bed in-world (i.e an item or instance of a bed). This is explained fully, with the equations on the Sleep Furniture's Surgery Success Chance Factor stat.
  • Added previously omitted per-operation success multipliers to the Doctoring page.
  • More consistently referred to operations as "operations" on the Doctoring page (at least in the scope of my edits so far).
  • Checked contradictions or questionable claims against the latest game version and adjust as necessary.

What I'd like to also do is (pending acceptance of the further edit):

  • Put in a redirect for Surgery -> Doctoring#Operations (Surgery) (there's already one for Operations -> Surgery).
  • Consider further breaking down the doctor's stat calculation to the Medical Surgery Success Chance page (where from an engineering standpoint it should really live) - then refer to it from the Doctoring page.
  • Do a quick check regarding nomenclature across the wiki wrt surgery vs operations - and make any changes needed if it will make things clearer. They should always link to the right place regardless.

Apologies that the diffs from my edits must look hefty and complex - however if you look at the resulting pages it makes the entire thing simple to understand, plus from an algorithmic standpoint it's accurate and complete. The changes are very localised and specific to the operation chance factors, even verbose. I've tried to ensure that no pertinent information has been discarded (if you see this, they have probably been moved to the correct page). I hope this explains my string of edits! It's difficult to explain this in an edit summary.