Tutorial is outdated: hermes create channel

[plafer]

Summary of Bug

According to the hermes tutorial, I should be able to run

hermes create channel ibc-0 ibc-1 --port-a transfer --port-b transfer

to create a client, connection and channel between chains ibc-0 and ibc-1. This current fails with error

error: Invalid value "ibc-1" for '<CONNECTION_A>': identifier ibc-1 has invalid length 5 must be between 10-64 characters

Version

v0.14.0

Steps to Reproduce

1. Spawn two chains (I used basecoin chains)
2. Make sure your hermes config knows about both chains
3. Run hermes create channel ibc-0 ibc-1 --port-a transfer --port-b transfer
4. Notice the aforementioned error

Acceptance Criteria

The hermes create channel command succeeds.

---

For Admin Use

• Not duplicate issue
• Appropriate labels applied
• Appropriate milestone (priority) applied
• Appropriate contributors tagged
• Contributor assigned/self-assigned

[romac]

The guide is outdated, the syntax for create channel is now

hermes create channel [OPTIONS] --port-a <PORT_A> --port-b <PORT_B> <CHAIN_A> [CONNECTION_A]

ie. the second positional argument is now the connection id.

I will update the guide later today, thanks for noticing!

PS: I am more and more convinced that we should eventually (for v1) move away from positional arguments and use flags everywhere.

[adizere]

PS: I am more and more convinced that we should eventually (for v1) move away from positional arguments and use flags everywhere.

++++1

[romac]

Guide is now up to date: https://hermes.informal.systems/tutorials/local-chains/relay-paths/create-new-path.html

[romac]

Output listed in the guide depends on #2158

[dylanschultzie]

@romac it appears the guide isn't updated still:

[adizere]

I was just about to approve #2245. Then I found this strange thing.

If I open
https://hermes.informal.systems/tutorials/local-chains/relay-paths/create-new-path.html

I see the correct, up-to-date instructions:

But this page is not consistent with the source code
https://github.com/informalsystems/ibc-rs/blob/b7fc78e99f189f3fcad836008720ccec788ed1ff/guide/src/tutorials/local-chains/relay-paths/create-new-path.md?plain=1#L3-L6

What am I missing?

[romac]

I already pushed the guide update manually to gh-pages but we now need to merge this to update master so that the update will be kept for the next version.