namecoin-core icon indicating copy to clipboard operation
namecoin-core copied to clipboard

Standardize on names for documentation

Open yanmaani opened this issue 5 years ago • 1 comments

Some of the documentation (e.g. for RPC commands) uses d/myname, some of it uses myname, some of it uses d/abc, and some of it uses d/domob.

It would be nice to standardize this. Just using myname without the d/ is confusing, but otherwise I don't have a strong opinion. I would suggest d/example, however it's squatted. d/namecoin might work. We could also use a specific namespace, like ex/domain, although this has some risk of confusion.

In upstream, there is a const std::string array EXAMPLE_ADDRESS with some (invalid) bech32 addresses. That is a good model of how to do it.

yanmaani avatar Jul 23 '20 16:07 yanmaani

Of these, I personally prefer d/namecoin or d/domob, but ACK on using a const std::string for this; we can bikeshed about which example name to use after it's factored out.

JeremyRand avatar Apr 26 '22 01:04 JeremyRand