Add localization keyword documentation

[SAKavli]

Issue
Resolves #12671

Approach
Short description of the approach

(Screenshot of new behavior in GUI if applicable)

• PR title captures the intent of the changes, and is fitting for release notes.
• Added appropriate release note label
• Commit history is consistent and clean, in line with the contribution guidelines.
• Make sure unit tests pass locally after every commit (git rebase -i main --exec 'just rapid-tests')

When applicable

• When there are user facing changes: Updated documentation
• New behavior or changes to existing untested code: Ensured that unit tests are added (See Ground Rules).
• Large PR: Prepare changes in small commits for more convenient review
• Bug fix: Add regression test for the bug
• Bug fix: Add backport label to latest release (format: 'backport release-branch-name')

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.97%. Comparing base (293883c) to head (ca82eb8).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #13936      +/-   ##
==========================================
- Coverage   91.97%   91.97%   -0.01%     
==========================================
  Files         484      484              
  Lines       33644    33672      +28     
==========================================
+ Hits        30945    30969      +24     
- Misses       2699     2703       +4     

Flag	Coverage Δ
cli-tests	36.49% <ø> (+0.07%)	⬆️
fuzz	44.36% <ø> (-0.03%)	⬇️
gui-tests	58.68% <ø> (-0.03%)	⬇️
performance-and-unit-tests	80.98% <ø> (+<0.01%)	⬆️
test	45.98% <ø> (+0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 9 files with indirect coverage changes

[codspeed-hq]

Merging this PR will not alter performance

✅ 36 untouched benchmarks

---

_{Comparing SAKavli:add-localization-keyword-documentation (ca82eb8) with main (6078659)}

[xjules]

Can EAST and NORTH be overwritten too?

[SAKavli]

For normal observation declarations, e.g. from_dict from obs config: yes
For observations loaded from csv: no

For normal observations, I now see that there is a "race condition" of what will be the north and east values, based on what is processed first:

        for key, value in observation_dict.items():
            match key:
                case "type" | "name":
                    pass
                case "WELL":
                    well = value
                case "PROPERTY":
                    observed_property = value
                case "VALUE":
                    observed_value = validate_float(value, key)
                case "ERROR":
                    error = validate_float(value, key)
                case "DATE":
                    date = value
                case "NORTH":
                    north = validate_float(value, key)
                case "EAST":
                    east = validate_float(value, key)
                case "TVD":
                    tvd = validate_float(value, key)
                case "CSV":
                    csv_filename = value
                case "ZONE":
                    zone = value
                case "MD":
                    md = validate_float(value, key)
                case "LOCALIZATION":
                    validate_rft_localization(value, observation_dict.context)
                    east, north, radius = extract_localization_values(value)
                    radius = (
                        radius if radius is not None else DEFAULT_LOCALIZATION_RADIUS
                    )
                case _:
                    raise _unknown_key_error(str(key), observation_dict.context)

Not great perhaps.

[SAKavli]

Just checked this, validate_rft_localization raises an error if NORTH or EAST are defined under the LOCALIZATION block

[xjules]

maybe an example how to specify the well inside an observation.

[xjules]

Nice work @SAKavli! 🚀

[SAKavli]

I have force pushed to update to the commit bodies.