Lighthouse book - Merge Migration section confusing

[winksaville]

Description

I found the Merge Migration instructions confusing. Mainly because I wasn't sure if new options were needed right now or should be added closer to when the merge is supposed to occur.

Version

v2.5.1

Present Behaviour

The confusion started here:

---

As of v2.4.0 Lighthouse can be considered to have two modes:

• Pre-merge: --execution-endpoint flag is not provided.
• Post-merge: --execution-endpoint flag is provided.

A pre-merge node, by definition, will fail to transition through the merge. Such a node must be upgraded before the Bellatrix upgrade.

---

I think the instructions could be more explicit, I found these CoinCashew instructions informative. Actually, there should be a Lighthouse Flags & Options section that would include "required" and "typical" options that are needed to run a bn and vc.

Expected Behaviour

I think this is more correct and to the point:

---

As of v2.4.0 Lighthouse bn and vc new options should be added ASAP but is required before the Bellatrix upgrade. And for testnets they Goerli/Prater this need to be done ASAP.

• For beacon node add --execution-endpoint and --execution-jwt options
• For validator clients add --suggested-fee-recipient

If these flags are not present your system will fail to transition through the merge.

---