Git Product home page Git Product logo

metagpt-docs's Introduction

MetaGPT-docs Contributing Guide

Overview

This repo hosts the documentation site for MetaGPT. To make a contribution, simply prepare a markdown file and submit a Pull Request (PR). Upon the approval and merge of your PR, your markdown document will be automatically rendered to the documentation website. We welcome a diverse range of submissions, from usage guidance and typo corrections to practical application and beyond!

File structure

 ├─ src
 │ ├─ en                     # English docs
 │ │ ├─ index.md             # Home page
 │ │ ├─ guide                # Content pages
 │ │ │ ├─ get_started        # Section on the website
 │ │ │ │ ├─ introduction.md  # One page on the website
 │ │ │ │ ├─ quickstart.md    # One page on the website
 │ │ │ │ ├─ ...              # More pages
 │ │ │ ├─ tutorials          # Section on the website
 │ │ │ ├─ ...                # More sections
 │ ├─ zh                     # 中文文档 Same structure as en
 │ ├─ rfcs                   # RFC files
 │ ├─ public                 # Resources, put images or videos here
 │ ├─ blog                   # Blog files
 │ ├─ utils                  # Some utils
 ├─ vitepress/config.mts     # Navbar & sidebar config

Make contribution

  • Find the file of your interest by navigating src/[language]/guide and make your changes. The files are aranged to reflect the hierarchy on the documentation site. For example, src/en/guide/get_started/quickstart.md corresponds to https://docs.deepwisdom.ai/en/guide/get_started/quickstart.html
  • Place your media files such as images or videos under src/public/image/guide, the path should correspond to the documents using the media. Documents of different languages use the same media. In your document, use relative path to refer to the media
  • Translate: If you are adding a new file, translate the documents to all languages. We will provide a Translator agent soon
  • For editting the sidebar, change src/.vitepress/config.mts, find the dictionary under sidebar
  • Commit and submit a PR, done!

Local Deployment

This section is relevant if you want to precheck how your changes will be rendered on the document site.

Prerequisites

Up and Running

follow steps below to start the dev server

  1. corepack enable pnpm to use pnpm

    or refer to pnpm Installation

  2. pnpm i to install dependency

  3. npm run docs:dev

The dev server should be running at http://localhost:5173. Visit the URL in your browser to see your new site in action!

metagpt-docs's People

Contributors

garylin2099 avatar zerolee1231 avatar better629 avatar luxiangtaoya avatar geekan avatar autofix-ci[bot] avatar oopsyoudiede avatar mannaandpoem avatar stitch-z avatar voidking avatar shenchucheng avatar eltociear avatar khill-fbmc avatar stellahsr avatar sure365 avatar

Stargazers

Moreira avatar

Watchers

Moreira 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.