Skip to content

Commit e0c3115

Browse files
KtorZcrptmppt
andauthored
(new) CIP-0001 & CIP-9999: Cardano Problem Statements (cardano-foundation#366)
* Publish CIP-0001 rework, alongside the first draft of CIP-9999 * Update README.md I changed the authors list to the original authors + added MPJ. As the CIP process hardly changes beside the CPS addition I feel it is fine to merge with the added change. If there are issues regarding the addended authorship on this PR, I suggest this be submitted as a different CIP #, which can override 0001 (this could then be noted in the body of 0001) - "convenience" should not override facts, having created 0001 and the entire original CIP process, I request original authorship of 0001 be noted in the PR. 
 Co-authored-by: Frederic J <[email protected]>
1 parent 5b50794 commit e0c3115

File tree

7 files changed

+997
-133
lines changed

7 files changed

+997
-133
lines changed

.github/CIP-TEMPLATE.md

+26-10
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,42 @@
11
---
22
CIP: ?
33
Title: ?
4-
Authors: John Doe <[email protected]>
5-
Status: Draft
6-
Type: Core | Process | Informational
4+
Category: ?
5+
Status: Proposed
6+
Authors:
7+
- John Doe <[email protected]>
8+
Implementors: []
9+
Discussions:
10+
- https://github.com/cardano-foundation/cips/pulls/?
711
Created: YYYY-MM-DD
812
License: CC-BY-4.0
913
---
1014

11-
## Abstract <!-- A short (~200 word) description of the technical issue being addressed and the proposed solution -->
15+
## Abstract
16+
<!-- A short (\~200 word) description of the proposed solution and the technical issue being addressed. -->
1217

13-
## Motivation <!-- A clear and short explanation introducing the reason behind a proposal. When changing an established design, it must outlines issues in the design that motivates a rework. -->
18+
## Motivation: why is this CIP necessary?
19+
<!-- A clear explanation that introduces the reason for a proposal, its use cases and stakeholders. If the CIP changes an established design then it must outline design issues that motivate a rework. For complex proposals, authors must write a Cardano Problem Statement (CPS) as defined in CIP-9999 and link to it as the `Motivation`. -->
1420

15-
## Specification <!-- The technical specification should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations. -->
21+
## Specification
22+
<!-- The technical specification should describe the proposed improvement in sufficient technical detail. In particular, it should provide enough information that an implementation can be performed solely on the basis of the design in the CIP. This is necessary to facilitate multiple, interoperable implementations. -->
1623

17-
## Rationale <!-- The rationale fleshes out the specification by describing what motivated the design and why particular design decisions were made. It should describe alternate designs that were considered and related work. The rationale should provide evidence of consensus within the community and discuss important objections or concerns raised during discussion. When applicable, it must also explain how the proposal affects backward-compatibility of existing solutions. -->
24+
## Rationale: how does this CIP achieve its goals?
25+
<!-- The rationale fleshes out the specification by describing what motivated the design and what led to particular design decisions. It should describe alternate designs considered and related work. The rationale should provide evidence of consensus within the community and discuss significant objections or concerns raised during the discussion.
1826
19-
## Path to Active <!-- A reference implementation, observable metrics or anything showing the acceptance of the proposal in the community. It must be completed before any CIP is given status “Active”, but it need not be completed before the CIP is accepted. It acts as a high-level roadmap for the proposal. -->
27+
It must also explain how the proposal affects the backward compatibility of existing solutions when applicable. If the proposal responds to a CPS, the 'Rationale' section should explain how it addresses the CPS, and answer any questions that the CPS poses for potential solutions.
28+
-->
2029

21-
## Copyright <!-- The CIP must be explicitly licensed under acceptable copyright terms (see below). -->
30+
## Path to Active
2231

23-
This CIP is licensed under [CC-BY-4.0][].
32+
### Acceptance Criteria
33+
<!-- Describes what are the acceptance criteria whereby a proposal becomes 'Active' -->
34+
35+
### Implementation Plan
36+
<!-- A plan to meet those criteria. Or `N/A` if not applicable. -->
37+
38+
## Copyright
39+
<!-- The CIP must be explicitly licensed under acceptable copyright terms. -->
2440

2541
[CC-BY-4.0]: https://creativecommons.org/licenses/by/4.0/legalcode
2642
[Apache-2.0]: http://www.apache.org/licenses/LICENSE-2.0

.github/CPS-TEMPLATE.md

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
CPS: ?
3+
Title: ?
4+
Status: Open
5+
Category: ?
6+
Authors:
7+
- John Doe <[email protected]>
8+
Proposed Solutions: []
9+
Discussions:
10+
- https://github.com/cardano-foundation/cips/pulls/?
11+
Created: YYYY-MM-DD
12+
---
13+
14+
## Abstract
15+
<!-- A short (\~200 word) description of the target goals and the technical obstacles to those goals. -->
16+
17+
## Problem
18+
<!-- A more elaborate description of the problem and its context. This section should explain what motivates the writing of the CPS document. -->
19+
20+
## Use cases
21+
<!-- A concrete set of examples written from a user's perspective, describing what and why they are trying to do. When they exist, this section should give a sense of the current alternatives and highlight why they are not suitable. -->
22+
23+
## Goals
24+
<!-- A list of goals and non-goals a project is pursuing, ranked by importance. These goals should help understand the design space for the solution and what the underlying project is ultimately trying to achieve.
25+
26+
Goals may also contain requirements for the project. For example, they may include anything from a deadline to a budget (in terms of complexity or time) to security concerns.
27+
28+
Finally, goals may also serve as evaluation metrics to assess how good a proposed solution is. -->
29+
30+
## Open Questions
31+
<!-- A set of questions to which any proposed solution should find an answer. Questions should help guide solutions design by highlighting some foreseen vulnerabilities or design flaws. Solutions in the form of CIP should thereby include these questions as part of their 'Rationale' section and provide an argued answer to each. -->

.github/badge.svg

+1
Loading

0 commit comments

Comments
 (0)