CIP-0001 | Titles for CIPs with common purpose

[rphair]

Discussion begun in #590 and currently, as agreed in today's editor meeting, with consensus so far that:

• the "pipe" (|) is a better choice than the colon to avoid YAML errors
• this may also be applicable to other CIP names: e.g. may be helpful for new token types as per CIP-0068, so should be generalised into CIP-0001... as opposed to CIP-0030 which would only cover extensions to the web-wallet bridge.

On that last note we also suggested @Ryun1 might add a similar instruction to CIP-0030 that those extensions be named as such (with Web-Wallet Bridge |), once it's confirmed here. In anticipation of this I've added an H6 (so far unused) to the document so it can be referenced easily with an external link.

BTW the merged CIP-0095 itself now follows this convention (Web-Wallet Bridge | Governance): https://github.com/cardano-foundation/CIPs/tree/master/CIP-0095

[rphair]

FYI, hold on review... there is a problem using the | character in a table (even when quoted as code), which my happy-go-lucky markdown editor rendered properly... though it's considered a further table column on GitHub & therefore disappears here. Will push out another commit or two based on some testing & syntax changes.

[rphair]

... OK, I think it's fixed now, using HTML <code> syntax + a charcode for the "pipe" which (as per the DTD for HTML based documents) should avoid the problems pointed out in #591 (i.e. the "easy fix" is escaping with \ but that wouldn't be portable).

[rphair]

Note: discussion is now open on reverting to the second-most-popular suggestion of using the - sign as a delimiter (suggested in #590 (comment) & #595 (comment)) especially because the extra markup required to put | in a table is bound to cause even worse problems than the YAML-unfriendly :. 😰

[rphair]

Reverted back to - for a delimiter as per reported problem & consensus in #595 (comment).