Kadena
Published in

Kadena

Kadena’s Community-Powered Developer Documentation

Entering 2022, the Kadena ecosystem is going into overdrive, so it’s critical that our developer documentation keep up. We’re thrilled to announce a major refresh of the Kadena developer documentation hub to supercharge builder’s access to information. What’s more, the docs are now fully community-powered, open- and crowd-sourced, tapping the incredible resources in our community to keep everything up-to-date and accurate. Read on to learn how you can get involved and move our ecosystem forward!

How to Contribute to Kadena Docs

There are 3 ways to contribute to the Docs depending on where you are starting from.

  • From the Docs
  • From GitHub
  • From a Local Environment.

This article goes over each of these options to help you suggest changes to the Kadena Docs.

Before Getting Started

Edit from the Docs

Edit from the GitHub Repo

Edit from a Local Environment

Before Getting Started

GitHub

Create a GitHub account here and read their documentation if you have trouble getting started.

Markdown

Learn about Markdown to better understand the syntax for editing documentation.

Docusaurus

Read the Docusaurus Docs to get familiar with the tool used to publish the Kadena Documentation.

Edit from the Docs

At the bottom of any page of the Kadena Documentation, you’ll see a link titled Edit this page.

Selecting this link takes you to the kadena-community/docs editor window for this page within GitHub.

Make adjustments as needed and preview your changes using the Preview tab.

Select the Show diff checkbox to view the changes inline.

To propose your changes, scroll to the bottom of the page, add notes about your changes, and select the radio button option to Create a new branch. Name your branch and select propose changes.

You have now proposed edits to the repo from the documentation. The Kadena team will review your request and merge your changes as soon as possible. View your pull request at any time to see any comments, questions, or suggestions throughout the duration of your pull request.

Edit from the GitHub Repo

Navigate to the Kadena Community GitHub and navigate to the Docs Repo.

Using the folder structure, navigate to the page you would like to edit. For example, docs/basics/overview.md. The location of this file corresponds to the URL found from within the documentation site.

Select the edit icon on the right side of the screen to begin editing the document.

Make adjustments as needed and preview your changes using the Preview tab.

Select the Show diff checkbox to view the changes inline.

To propose your changes, scroll to the bottom of the page, add notes about your changes, and select the radio button option to Create a new branch. Name your branch and select propose changes.

You have now proposed edits to the repo from GitHub. The Kadena team will review your request and merge your changes as soon as possible. View your pull request at any time to see any comments, questions, or suggestions throughout the duration of your pull request.

Edit from a Local Environment

Navigate to kadena-community/docs and select Fork on the top right of your screen.

Select your profile to create a fork of this repo on your personal GitHub account.

Navigate to your docs repo fork and copy the URL from the code dropdown.

Open your terminal, navigate to your preferred folder, and clone the repository.

Example

git clone https://github.com/kadena-community/docs.git

Change into the docs/ directory

cd docs

Run yarn to install the project dependencies.

yarn

Run yarn dev to run the local server.

yarn dev

Navigate to localhost:3000 to view the documentation on local device.

Open the docs folder in your favorite code editor to make changes to the documentation (example: docs > basics > what-is-kda.md). Use markdown to edit the page and save the file to view your changes.

When you are done editing, check the status of your changes from your terminal window.

git status

Use git add to add stage your changes to commit to your local repository.

git add .

Use git commit to commit your changes to your local repository.

git commit -m ‘how to edit docs’

Use git push to push your changes to your remote repository.

git push origin master

Select Contribute > Open pull request from within your remote repository.

You have now created a pull request to the repo from a local environment. The Kadena team will review your request and merge your changes as soon as possible. View your pull request at any time to see any comments, questions, or suggestions throughout the duration of your pull request.

We’re also on: Twitter | Linkedin | Github| Reddit| Discord

--

--

--

Kadena has the only scalable layer 1 PoW blockchain along with Pact, the safest smart contract language. Founded by @SirLensALot & @_wjmartino_ who created JP Morgan’s first blockchain and was the tech lead for the SEC’s first Crypto Committee.

Recommended from Medium

Elixir deployments on AWS

Modern, native tool for relational database

Recap Session of Dapp list Ama held at Cryptomansion

Python function to convert one or multiple PDF files to JPG image files

Flutter: Data-binding with Jetspike

How to Uninstall System Apps without Root

How to debug a compute buffer on Unity

Comparing Traits in Rust to Type Classes in Scala

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Jeffrey Ou

Jeffrey Ou

More from Medium

Mint a Marketplace! NFTs on Kadena Marmalade (Part 1)

The Babenas of Kadena

VOLTSWAP launch on Theta Mainnet — A harbinger of DeFi downpour!

Why we love Kadena ‘s Marmalade NFT Standard — from the perspective of DNA’s CTO