Giter VIP home page Giter VIP logo

website's Introduction

Kmesh Docs & Website

This repo contains the source code of Kmesh Website and all of the docs for Kmesh.

Welcome to join us and you are more than appreciated to contribute!

Quick Start

Here's a quick guide to updating the docs. It assumes you're familiar with the GitHub workflow and you're happy to use the automated preview of your doc updates:

  1. Fork the Kmesh/website repo on GitHub.
  2. Make your changes and send a pull request (PR).
  3. If you're not yet ready for a review, add a comment to the PR saying it's a work in progress or add [WIP] in your PRs title. You can also add /hold in a comment to mark the PR as not ready for merge.
  4. Wait for the automated PR workflow to do some checks. When it's ready, you should see a comment like this: Deploy Preview for kmesh-net ready!
  5. Click Details to the right of "Deploy preview ready" to see a preview of your updates.
  6. Continue updating your doc until you're happy with it.
  7. When you're ready for a review, add a comment to the PR and assign a reviewer/approver. See the Kmesh contributor guide.

Notes of Writing Documentation

In the Kmesh documentation, a note is required at the beginning of each document as follows:

---
draft: false
linktitle: XXX
menu:
  docs:
    parent: XXX
    weight: 1
title: XXX
toc: true
type: docs

---

There are four points to note:

  • linktitle is the title displayed in the menu.
  • title is the title displayed on the document page.
  • parent indicates which directory this document is contained in. For example, if you want to write a document under the user guide, you need to set the parent: user guide. For the correspondence of each menu, please refer to menus. A simpler way is to directly copy the configuration of the existing documents in the directory.
  • weight is used to order the documents. Should avoid duplication and conflicts prevented. It is also best not to use adjacent numbers to facilitate the insertion of new documents. A spacing of 5 is recommended. If you want your document to always be at the end of the current directory, you can just use 99.

website's People

Contributors

nlgwcy avatar lizhencheng9527 avatar kmesh-bot avatar yaozengzeng avatar supercharge-xsy avatar lec-bit avatar kwb0523 avatar okabe-rintarou-0 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.