CIP-0029 | Adjust preamble and structure w.r.t CIP-0001 (#678)

* first draft remediation of CIP-0029

* fixing PR URL syntax error

* Test Vectors somehow ended up in the Rationale

* not only cardano-api but also cardano-cli standalones appear move to IntersectMBO

Author: rphair

CIP-0029/README.md

@@ -1,60 +1,50 @@
 ---
 CIP: 29
 Title: Phase-1 Monetary Scripts Serialization Formats
-Authors: Matthias Benkort <[email protected]>
-Comments-URI: https://github.com/cardano-foundation/CIPs/pulls/117
 Status: Active
-Type: Standards
+Category: Tools
+Authors:
+  - Matthias Benkort <[email protected]>
+Implementors:
+  - IOG
+Discussions:
+  - https://github.com/cardano-foundation/CIPs/pull/117
 Created: 2020-08-17
 License: CC-BY-4.0
 ---
 
-# Abstract
+## Abstract
 
-This specification describes how to serialize Phase-1 monetary scripts (a.k.a. _"native scripts"_) to various formats (JSON, CBOR) to facilitate inter-operability between applications. 
+This specification describes how to serialize Phase-1 monetary scripts (a.k.a. _"native scripts"_) to various formats (JSON, CBOR) to facilitate inter-operability between applications.
 
-# Motivation
+## Motivation: why is this CIP necessary?
 
 While the existence of scripts is well-known, and have an unambiguous on-chain representation. There's no agreed upon format for off-chain or higher-level interfaces for which a binary string is a poor fit. This CIP regroups both the on-chain binary format and other, more verbose, formats like JSON.
 
-# Specification
+## Specification
 
-This specification covers at present two serialization formats: JSON and CBOR. The CBOR matches exactly the on-chain representation and is extracted from the cardano-ledger-specs source code and put here as a convenient place to lookup while the source can change location over time. 
+This specification covers at present two serialization formats: JSON and CBOR. The CBOR matches exactly the on-chain representation and is extracted from the cardano-ledger-specs source code and put here as a convenient place to lookup while the source can change location over time.
 
-## CBOR
+### CBOR
 
-The CBOR serialization format is given as a [CDDL specification in annexe](./phase-1-monetary-scripts.cddl). When a hash of the phase-1 monetary script is needed, it usually refers to a Blake2b-192 digest of the corresponding serialized script byte-string prefixed with a null byte: `\x00`. 
+The CBOR serialization format is given as a [CDDL specification in annexe](./phase-1-monetary-scripts.cddl). When a hash of the phase-1 monetary script is needed, it usually refers to a Blake2b-192 digest of the corresponding serialized script byte-string prefixed with a null byte: `\x00`.
 
-## JSON 
+### JSON
 
-The JSON format is given as a [JSON schema in annexe](./phase-1-monetary-scripts.json). It is preferred in user interfaces such as command-lines or APIs, where some level of human inspection may be required. 
+The JSON format is given as a [JSON schema in annexe](./phase-1-monetary-scripts.json). It is preferred in user interfaces such as command-lines or APIs, where some level of human inspection may be required.
 
-## Notes
+### Notes
 
 - Scripts may contain unbounded integers! Implementation parsing them, either from CBOR or JSON shall be prepared to handle possible big integers (>= 2^64).
 
-# Rationale
-
-- The preimage for computing script hashes is prefixed with `\x00` to distinguish them from phase-2 monetary scripts (a.k.a Plutus Script) which are then prefixed with `\x01`. This is merely a discriminator tag.
-
-- The current JSON format is based off the cardano-cli's format which has been used widely for minting tokens and is likely the most widely accepted format at the moment.
-
-# Backward Compatibility
-
-N/A
-
-# Reference Implementation(s)
-
-- [cardano-cli](https://github.com/input-output-hk/cardano-node/tree/master/cardano-cli) & [cardano-api](https://github.com/input-output-hk/cardano-node/tree/master/cardano-api)
-
-## Test Vectors
+### Test Vectors
 
 ```yaml
 - json:
     { "type": "sig"
     , "keyHash": "00000000000000000000000000000000000000000000000000000000"
     }
-  cbor: 
+  cbor:
     "8200581c00000000000000000000000000000000000000000000000000000000"
 
 - json:
@@ -64,7 +54,7 @@ N/A
         , "keyHash": "00000000000000000000000000000000000000000000000000000000"
         }
       , { "type": "any"
-        , "scripts": 
+        , "scripts":
           [ { "type": "after"
             , "slot": 42
             }
@@ -82,7 +72,7 @@ N/A
     { "type": "before"
     , "slot": 42
     }
-  cbor: 
+  cbor:
     "8205182a"
 
 - json:
@@ -98,6 +88,24 @@ N/A
     "00830302838200581c000000000000000000000000000000000000000000000000000000008200581c000000000000000000000000000000000000000000000000000000018200581c00000000000000000000000000000000000000000000000000000002"
 ```
 
-# Copyright
+## Rationale: how does this CIP achieve its goals?
+
+- The preimage for computing script hashes is prefixed with `\x00` to distinguish them from phase-2 monetary scripts (a.k.a Plutus Script) which are then prefixed with `\x01`. This is merely a discriminator tag.
+
+- The current JSON format is based off the cardano-cli's format which has been used widely for minting tokens and is likely the most widely accepted format at the moment.
+
+## Path to Active
+
+### Acceptance Criteria
+
+- [x] There exist official software releases supporting this serialization format:
+  - [x] [cardano-cli](https://github.com/IntersectMBO/cardano-cli)
+  - [x] [cardano-api](https://github.com/IntersectMBO/cardano-api)
+
+### Implementation Plan
+
+  - [x] Incorporating this serialization format into Cardano software libraries and command line tools.
+
+## Copyright
 
-CC-BY-4.0
+This CIP is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).