Giter VIP home page Giter VIP logo

direflow-docs's Introduction

direflow.io - official webpage

This repository contains the source code for the official webpage of direflow.

Contribute to the documentation

Get started

  1. Fork this repository
  2. Clone down your fork to your local machine
  3. cd into the cloned repository using cd direflow-docs
  4. Create a branch with a suitable name for the change you want to add
  5. Start the project locally using yarn start
    The project will be running at https://localhost:8000

Overview

The page consists of two parts; a front page and a documentation section.
All documentation page are written in markdown format, and is found in the folder src/pages/docs.
Here, you can add an edit documentation.

Edit documentation

This part is simple - just edit the part of the documentation that you whish to be changed.

Adding new documentation pages

In order to add new documentation pages, follow this procedure:

  1. Create a new folder under src/pages/docs reflecting the name of your documentation page.
  2. Create an mdx-file under this new folder with the same name. src/docs/new-doc/new-doc.mdx.
  3. Make sure that the mdx-file contains the following front matter:
     ---
     name: 'New Doc'
     route: '/new-doc'
     edit: false
     ---
  4. Make sure to add a button at the end of the page, pointing to the next documentation page:
    Import the following on the top of the page:
    import { Link } from '@reach/router';
    import { Button } from '../../components/Jumbotron/Styles';
    Add the button at the end of the page
    <span style="display: flex; justify-content: center">
       <Link to='/next-docs'>
          <Button>โ†’ Next Docs</Button>
       </Link>
    </span>
    Make sure to replace 'nex-docs' with the route to the next page in the menu.
  5. Lastly, go to the file doczrc.js and add a menu item for your new documentation page:
    This should be the same as the 'name' property in the front matter.
    menu: [
     'Introduction',
     'Get started',
     'Properties',
     'Events',
     'Styling',
     'Plugins',
     'Additional',
     'Contributing',
     'Changelog',
     'New Doc'
    ]

Submitting changes to the webpage

Push

When you're done with your changes, simply push these changes to the branch that you created.

Create PR

Go to the main direflow-docs repository and create a PR with your changes. We will be reviewing shortly.

direflow-docs's People

Contributors

nicolas-cunin-lyra avatar simonhoiberg avatar

Watchers

James Cloos 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.