Cardano Relay Configuration: fix & clarify instructions

[sanskys]

• I have read the How to Contribute.
• I have run yarn build after adding my changes without getting any errors.

Updating documentation or Bugfix

Documentation Update to Fix #1140

1. $HOME is being replaced by <$HOME> to reflect real value
2. ".local" is being replaced by "local"
3. conway-genesis.json file has been added

[rphair]

I don't think this page is maintainable for reasons @rdlrt already gave in #1140 (comment) ... and therefore I believe most of the content on this page should be replaced with links to the relevant sections on the canonical page Installing cardano-node and cardano-cli from source.

As long as the redundancy in the page remains, though, we would still have to do some cleanup. Some feedback about the proposed changes:

[sanskys]

if a cleanup is planned, should i close this PR. Alternatively, i could make the suggested changes as an interim solution?

[rphair]

@sanskys I would want to hear what other reviewers think about this, but I still firmly believe the only suitable change to make to this page is to eliminate the redundant material, replacing it with link(s) to the more canonical Dev Portal source.

Perhaps the page & workflow could be simplified with wording like: "Now that you've created a node according to these (link) standard instructions, here's how to configure it as a relay for your stake pool."

In any case I believe it would be a huge contribution if you could revise your fixes to strip down most of the content & only include those instructions that are unique to SPOs & their relays, without the general node maintenance & operation. What do you think of that plan? 🤓

[sanskys]

@sanskys I would want to hear what other reviewers think about this, but I still firmly believe the only suitable change to make to this page is to eliminate the redundant material, replacing it with link(s) to the more canonical Dev Portal source.

Perhaps the page & workflow could be simplified with wording like: "Now that you've created a node according to these (link) standard instructions, here's how to configure it as a relay for your stake pool."

In any case I believe it would be a huge contribution if you could revise your fixes to strip down most of the content & only include those instructions that are unique to SPOs & their relays, without the general node maintenance & operation. What do you think of that plan? 🤓

@rphair thats fine for me. But since the cleanup would take some time, I would recommend to merge these changes and open a new Issue. I would also like to hear more voices before starting. It should not be that after the cleanup everyone finds it a mishmash :)

[rphair]

sure thing @sanskys - I'll approve this for merge if it gets approval from 2 other reviewers. 🙂

[rphair]

I've backed out all the superflous & contraindicated changes from the standard ~/.local to the unusual ~/local. The only remaining changes here are the vital Conway genesis file & the less vital instructions about updating the "script" which also adds the error-prone angle brackets. Due to the latter issue I believe this should be considered an interim edit, pending I hope folding most of this page into links to more canonical instructions 🤓