Skip to content
This repository has been archived by the owner on Aug 24, 2023. It is now read-only.

Commit

Permalink
chore(docs): add documentation structure for MetaChain (#90)
Browse files Browse the repository at this point in the history
#### What this PR does / why we need it:

As per the title. Merely cosmetic change to move documentation structure
into place.

#### Which issue(s) does this PR fixes?:

<!--
(Optional) Automatically closes linked issue when PR is merged.
Usage: `Fixes #<issue number>`, or `Fixes (paste link of issue)`.
-->

Fixes part of #8
  • Loading branch information
fuxingloh authored Sep 14, 2022
1 parent 6586bc9 commit 20aba30
Show file tree
Hide file tree
Showing 13 changed files with 54 additions and 40 deletions.
12 changes: 0 additions & 12 deletions docs/:000:index.md

This file was deleted.

5 changes: 0 additions & 5 deletions docs/:100:Specification/:010:rpc-interface.md

This file was deleted.

7 changes: 0 additions & 7 deletions docs/:100:Specification/:099:iterations.md

This file was deleted.

17 changes: 17 additions & 0 deletions docs/:200:DeFiChain Basics/:100:what-is-metachain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: What is MetaChain?
---

`DeFiCh/metachain` started as a codename research & development
for [DFIP 2111-B: VOC: Ethereum Virtual Machine (EVM) Support](https://github.com/DeFiCh/dfips/issues/96). Proposed as a
DFIP on Nov 2021; DFIP 2111-B provided DeFiChain with more flexibility to think beyond what is possible today. It
introduced a new dimension to the DeFiChain ecosystem, allowing us to stretch the definition of Native DeFi.

- Smart contract capability through a turing-complete environment for faster paced innovation
- Embrace the multi-chain future enabling easier cross compatibility and extensibility.

---

:::div{class="admonitions red"}
TODO
:::
3 changes: 3 additions & 0 deletions docs/:200:DeFiChain Basics/:110:what-is-nativechain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: What is NativeChain?
---
3 changes: 3 additions & 0 deletions docs/:200:DeFiChain Basics/:120:what-is-dfi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: What is DFI?
---
3 changes: 3 additions & 0 deletions docs/:200:DeFiChain Basics/:500:wallet.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: DeFiChain Wallets
---
3 changes: 3 additions & 0 deletions docs/:300:MetaChain Protocol/:100:whitepaper.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: MetaChain Whitepaper
---
3 changes: 3 additions & 0 deletions docs/:300:MetaChain Protocol/:200:improvement-proposal.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: MetaChain Improvement Proposal
---
3 changes: 3 additions & 0 deletions docs/:300:MetaChain Protocol/:300:token-bridge.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: MetaChain Tokens & Bridge
---
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Contributing Guide
title: Contributing Code
---

Thanks for contributing, appreciate all the help we can get. Feel free to make a pull-request, we will guide you along
Expand Down Expand Up @@ -72,7 +72,7 @@ In `./packages/*`, it contains E2E test and packages for using and building on D
pnpm install
```

### pnpm
### Installing pnpm

If you have the brew package manager installed, you can install pnpm using the following command `brew install pnpm`.
Otherwise, you should use the [standalone script to install](https://pnpm.io/installation#using-a-standalone-script). It
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: Writing Documentation
title: Contributing Documentation
---

Powered by [BirthdayResearch/contented](https://contented.dev), `contented.js` allows prose/markdown to be developed
within its contextual repository as micro-docs. Separating content generation from content presentation. Downstream
(e.g. defichain.com) can pull structured prose and represent them however they like.
Powered by [BirthdayResearch/contented](https://contented.dev), `docs/contented.config.js` allows prose/markdown to be
developed within its contextual repository as "micro-docs". Separating content generation from content presentation.
Downstream(e.g. defichain.com) can pull structured prose and represent them however they like.
**Commit your documentation into the repository together with your code.**

> Why micro-docs? Think of a modern web-app, it is commonly agreed among developers in this decade that organizing files
Expand All @@ -14,7 +14,7 @@ within its contextual repository as micro-docs. Separating content generation fr
---

## Installing
### Installing

Optional! You can treat it like you are committing plain old markdown files. CI/CD are added into this repository, you
can let the CI/CD compile and generate the preview for you.
Expand All @@ -24,27 +24,27 @@ pnpm install
pnpm run write
```

## Structuring your Markdown
### Structuring your Markdown

```
docs/
├─ 01:Sections/
│ ├─ 01:Sub Sections 1/*.md
│ ├─ 02:Sub Sections 2/*.md
│ ├─ 90:overview.md
│ └─ 99:faq.md
├─ :01:Sections/
│ ├─ :01:Sub Sections 1/*.md
│ ├─ :02:Sub Sections 2/*.md
│ ├─ :90:overview.md
│ └─ :99:faq.md
├─ .gitignore
├─ contented.js
├─ package.json
└─ package-lock.json
```

Files are ordered alphabetically, contented allows you to prefix your markdown file or directory with a number
prefix (`[0-9]+:(.+).md`, e.g. `01:file.md`). With the number prefix set, you can control how your content are sorted.
prefix (`:[0-9]+:(.+).md`, e.g. `:01:file.md`). With the number prefix set, you can control how your content are sorted.

## Supported Features
### Supported Features

[contented.dev/markdown](https://contented.dev/markdown)
See [contented.dev/markdown](https://contented.dev/markdown)

### Frontmatter

Expand Down
3 changes: 3 additions & 0 deletions docs/:900:MetaChain Governance/:200:node-upgrades.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: MetaChain Node Upgrades
---

0 comments on commit 20aba30

Please sign in to comment.