Merge pull request #732 from dfinity/revert-back-md

fix: Revert back to .md and add links to GitHub code

Author: jessiemongeon1

hosting/godot-html5-template/README.mdx renamed to hosting/godot-html5-template/README.md

@@ -2,12 +2,9 @@
 keywords: [html5, html, godot, hosting, host a website, beginner]
 ---
 
-
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Godot HTML5 sample
 
-<MarkdownChipRow labels={["Beginner"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/hosting/godot-html5-template)
 
 ## Overview
 The example shows how to deploy a Godot HTML5 build on the IC in an asset canister. The Godot HTML5 build is deployed as frontend, no backend is needed in this sample.

hosting/photo-storage/README.mdx renamed to hosting/photo-storage/README.md

@@ -2,11 +2,9 @@
 keywords: [photo storage, store photos, photo app, photos, beginner]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Photo storage example
 
-<MarkdownChipRow labels={["Beginner"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/hosting/photo-storage)
 
 The example shows how to store photos on ICP in an asset canister with the `@dfinity/assets` package. The photo
 storage app is deployed as a frontend in an asset canister which is also used for photo upload.

hosting/static-website/README.mdx renamed to hosting/static-website/README.md

@@ -2,11 +2,9 @@
 keywords: [static website, basic website, html, host a website, beginner]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Static website
 
-<MarkdownChipRow labels={["Beginner"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/hosting/static-website)
 
 ## Overview
 The example shows how to deploy a simple, static website on the IC in an asset canister. The website is very simple, it just shows the DFINITY logo and has a basic styling of the logo. 

hosting/unity-webgl-template/README.mdx renamed to hosting/unity-webgl-template/README.md

@@ -2,11 +2,9 @@
 keywords: [unity, unity webgl, beginner]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Unity WebGL sample
 
-<MarkdownChipRow labels={["Beginner"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/hosting/unity-webgl-template)
 
 The example shows how to deploy a simple Unity WebGL build on ICP in an asset canister. It just shows a Unity WebGL build with the URP template installed. 
 

motoko/actor_reference/README.mdx renamed to motoko/actor_reference/README.md

@@ -2,11 +2,9 @@
 keywords: [motoko, beginner, motoko actor, actor reference]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Actor reference
 
-<MarkdownChipRow labels={["Beginner", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/actor_reference)
 
 ## Overview
 
@@ -33,6 +31,7 @@ This is a Motoko example that does not currently have a Rust variant.
 This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/).
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 

motoko/auth_client_demo/README.mdx renamed to motoko/auth_client_demo/README.md

@@ -2,11 +2,9 @@
 keywords: [intermediate, motoko, authentication, internet identity, integrate, auth, user auth]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Auth-client 
 
-<MarkdownChipRow labels={["Intermediate", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/auth_client_demo)
 
 This is an example project intended to demonstrate how a developer might integrate with [Internet Identity](https://identity.ic0.app).
 
@@ -23,7 +21,8 @@ This example shows how to use [@dfinity/auth-client](https://www.npmjs.com/packa
 To get started, start a local `dfx` development environment in this directory with the following steps:
 
 ```bash
-cd auth-client-demo/
+git clone https://github.com/dfinity/examples
+cd examples/motoko/auth-client-demo/
 dfx start --background --clean
 dfx deps deploy
 dfx deploy

motoko/basic_bitcoin/README.mdx renamed to motoko/basic_bitcoin/README.md

@@ -2,11 +2,9 @@
 keywords: [advanced, motoko, bitcoin, bitcoin integration, btc]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Basic Bitcoin
 
-<MarkdownChipRow labels={["Advanced", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/basic_bitcoin)
 
 ## Overview 
 This tutorial will walk you through how to deploy a sample [canister smart contract](https://wiki.internetcomputer.org/wiki/Canister_smart_contract) **that can send and receive Bitcoin** on the Internet Computer.

motoko/basic_dao/README.mdx renamed to motoko/basic_dao/README.md

@@ -2,12 +2,9 @@
 keywords: [advanced, motoko, dao, decentralized organization, decentralized org]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Basic DAO
 
-<MarkdownChipRow labels={["Advanced", "Motoko"]} />
-
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/basic_dao)
 
 This sample project demonstrates a basic [decentralized autonomous organization](https://en.wikipedia.org/wiki/Decentralized_autonomous_organization) (DAO) that can be deployed to the [Internet Computer](https://github.com/dfinity/ic). The basic DAO sample code is available in [Motoko](https://github.com/dfinity/examples/tree/master/motoko/basic_dao) and [Rust](https://github.com/dfinity/examples/tree/master/rust/basic_dao). You can see a quick introduction on [YouTube](https://youtu.be/3IcYlieA-EE).
 
@@ -27,13 +24,14 @@ This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/).
 - [x] To run the test scripts, you need to download [ic-repl](https://github.com/chenyan2002/ic-repl/releases).
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 
  ### Step 1: Navigate into the folder containing the project's files and start a local instance of the Internet Computer with the command:
 
 ```bash
-cd basic_dao
+cd examples/motoko/basic_dao
 dfx start --background
 ```
 

motoko/calc/README.mdx renamed to motoko/calc/README.md

@@ -2,11 +2,10 @@
 keywords: [basic, motoko, calculator, calc]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Calculator 
 
-<MarkdownChipRow labels={["Beginner", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/calc)
+
 
 ## Overview
 
@@ -27,6 +26,7 @@ This is a Motoko example that does not currently have a Rust variant.
 This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/index.mdx).
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 

motoko/cert-var/README.mdx renamed to motoko/cert-var/README.md

@@ -2,11 +2,9 @@
 keywords: [intermediate, motoko, cert var, certified variables]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Certified variables
 
-<MarkdownChipRow labels={["Intermediate", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/cert-var)
 
 ## Overview
 This example demonstrates the use of a single cryptographically certified variable, as supported by the Internet Computer.
@@ -53,6 +51,7 @@ This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/index.mdx).
 - [x] Download [npm](https://nodejs.org/en/download/).
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 

motoko/classes/README.mdx renamed to motoko/classes/README.md

@@ -2,11 +2,9 @@
 keywords: [beginner, motoko, classes, actor classes]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Classes
 
-<MarkdownChipRow labels={["Beginner", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/classes)
 
 ## Overview
 
@@ -33,6 +31,7 @@ This is a Motoko example that does not currently have a Rust variant.
 This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/).
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 

motoko/composite_query/README.mdx renamed to motoko/composite_query/README.md

@@ -2,11 +2,9 @@
 keywords: [beginner, motoko, composite queries, queries]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Composite queries
 
-<MarkdownChipRow labels={["Beginner", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/composite_query)
 
 ## Overview
 
@@ -41,9 +39,11 @@ Each new `Bucket` must be provisioned with enough cycles to pay for its installa
 
 Verify the following before running this demo:
 
-*  You have downloaded and installed [dfx](https://sdk.dfinity.org).
+- [x] You have downloaded and installed [dfx](https://sdk.dfinity.org).
+
+- [x] You have stopped any process that would create a port conflict on `8000`.
 
-*  You have stopped any process that would create a port conflict on `8000`.
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 ## Install
 
@@ -58,6 +58,7 @@ dfx start
 ### Step 3: Deploy the `Map` canister:
 
 ```bash
+cd examples/motoko/composite_query
 dfx deploy
 ```
 

motoko/counter/README.mdx renamed to motoko/counter/README.md

@@ -2,11 +2,9 @@
 keywords: [beginner, motoko, counter, count]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Counter
 
-<MarkdownChipRow labels={["Beginner", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/counter)
 
 ## Overview
 
@@ -24,6 +22,7 @@ The application provides an interface that exposes the following methods:
 This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/index.mdx).
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 

motoko/defi/README.mdx renamed to motoko/defi/README.md

@@ -2,11 +2,9 @@
 keywords: [advanced, motoko, defi, decentralized exchange, dex, exchange]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Decentralized exchange sample
 
-<MarkdownChipRow labels={["Advanced", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/defi)
 
 ## Overview
 
@@ -98,7 +96,6 @@ Compared to depositing funds, withdrawing funds is simpler. Since the exchange h
 
 ```bash
 git clone --recurse-submodules --shallow-submodules https://github.com/dfinity/examples.git
-# for the rust implementation examples/rust/defi
 cd examples/motoko/defi
 make install
 ```

motoko/dip721-nft-container/README.mdx renamed to motoko/dip721-nft-container/README.md

@@ -2,11 +2,9 @@
 keywords: [advanced, motoko, nfts, dip721]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # DIP721 NFTs
 
-<MarkdownChipRow labels={["Advanced", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/dip721-nft-container)
 
 This example demonstrates implementing an NFT canister. NFTs (non-fungible tokens) are unique tokens with arbitrary
 metadata, usually an image of some kind, to form the digital equivalent of trading cards. There are a few different

motoko/echo/README.mdx renamed to motoko/echo/README.md

@@ -2,11 +2,9 @@
 keywords: [beginner, motoko, echo]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Echo
 
-<MarkdownChipRow labels={["Beginner", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/echo)
 
 ## Overview
 
@@ -19,6 +17,7 @@ This is a Motoko example that does not currently have a Rust variant.
 This example requires an installation of:
 
 - [x] Install the [IC SDK](https://internetcomputer.org/docs/current/developer-docs/setup/install/).
+- [ ] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
 
 Begin by opening a terminal window.
 

motoko/encrypted-notes-dapp-vetkd/README.mdx renamed to motoko/encrypted-notes-dapp-vetkd/README.md

@@ -2,11 +2,9 @@
 keywords: [advanced, motoko, encrypted, encrypted notes, notes dapp, vetkeys, vetkd]
 ---
 
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
 # Encrypted notes: vetKD
 
-<MarkdownChipRow labels={["Advanced", "Motoko"]} />
+[View this sample's code on GitHub](https://github.com/dfinity/examples/tree/master/motoko/encrypted-notes-dapp-vetkd)
 
 This is a copy of the `encrypted-notes-dapp` example, adapted to use [the proposed vetKD feature](https://github.com/dfinity/interface-spec/pull/158) and add sharing of notes between users.
 
@@ -16,16 +14,22 @@ The vetKey used to encrypt and decrypt a note is note-ID-specific (and not, for
 
 Currently, the only way to use this dapp is via manual local deployment (see below).
 
-Please also see the [README of the original encrypted-notes-dapp](../encrypted-notes-dapp/README.mdx) for further details.
+Please also see the [README of the original encrypted-notes-dapp](../encrypted-notes-dapp/README.md) for further details.
 
 ## Disclaimer
 
 This example uses an **insecure** implementation of [the proposed vetKD system API](https://github.com/dfinity/interface-spec/pull/158) in a pre-compiled form via the [vetkd_system_api.wasm](./vetkd_system_api.wasm). **Do not use this in production or for sensitive data**! This example is solely provided **for demonstration purposes** to collect feedback on the mentioned vetKD system API.
 
 ## Manual local deployment
+
+### Prerequisites
+
+- [x] Clone the example dapp project: `git clone https://github.com/dfinity/examples`
+
 ### Step 1: Choose which implementation to use by setting a respective environment variable.
 
-For **Motoko** deployment use
+For **Motoko** deployment use:
+
 ```sh
 export BUILD_ENV=motoko
 ```
@@ -70,6 +74,7 @@ If you have multiple `dfx` identities set up, ensure you are using the identity
 :::
    1. To install and deploy a canister run:
       ```sh
+      cd examples/motoko/encrypted-notes-dapp-vetkd
       dfx deploy internet_identity --argument '(null)'
       ```
    2. To print the Internet Identity URL, run: