Giter VIP home page Giter VIP logo

mage0s-devdocs's Introduction

Hello, Mage-OS Developer! ๐Ÿ‘‹

Welcome to the Mage-OS DevDocs repository. If you're here to contribute, or even just to learn, we're thrilled to have you. Below are some guidelines and notes to make your experience with us smooth and beneficial for everyone.

๐ŸŽ‰ Every Contribution Counts!

We genuinely mean it when we say every contribution counts. Did you spot a typo? Feel the need to correct a spelling issue? Even these small gestures go a long way in enhancing the quality of our DevDocs. So, don't hesitate. We appreciate your keen eyes!

๐Ÿ“‹ Issues & Topics

If there's something you'd like to see documented or feel something's amiss, don't just keep it to yourself. Open up an issue! We're always on the lookout for topics that can add value to Mage-OS DevDocs.

๐Ÿ—บ Navigation & New Pages

Want to add a new page? Great! Make sure you reference it in the documentation.md which serves as our central navigation. This ensures everyone can find your valuable addition.

๐Ÿ“„ Formatting & Structure

Every document you create should start with a # Headline and be followed by a [TOC]. This helps in generating the Table of Contents. We plan to add help in the form of GitHub Actions to point out potential Layout Flaws, misspellings, toxic language, non-inclusive language, or similar issues.

๐Ÿ—ฃ Tone & Voice

Documentation can often feel like a tedious read, but not here. While we aim to be exact and knowledgeable, we also strive to be beginner-friendly. Put on your informative cap, but remember, our readers range from beginners to experts. Aim for clarity and simplicity.

๐ŸŽ™ Join Our Discord Community

Got questions? Need clarifications? Or just want to chat? Join us on our Discord Server! Hop into the #documentation channel for all things related to the DevDocs. We're a friendly bunch, and someone's always around to help or have a chat. Join the Discord Server

๐Ÿ–ผ Images

A picture's worth a thousand words! If you'd like to add images to your documentation, please place them in the media directory. This helps keep things neat and organized.

๐Ÿš€ Keep It Simple

We've designed this repository to be as straightforward as possible. You'll mostly find Markdown files and the media directory here. No fancy structures. No complicated workflows. We like to keep things light and breezy.

โš ๏ธ Disclaimer

A portion of our initial documentation was crafted with the assistance of artificial intelligence. While it has provided valuable insights, not everything has undergone a human review or validation. We're continuously working on enhancing and verifying the content, but if you spot any inaccuracies, do bring it to our attention.

Mage-OS Documentation

๐Ÿ’…๐Ÿป Markup and Features

We support GitHub Flavored Markdown, including code blocks with triple backticks. You can also add highlight areas within your documentation.

Preview of Markdown rendered Info Boxes

> **Note**  
> Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aut dignissimos dolorum exercitationem fuga maxime
perspiciatis quae sapiente sunt veniam, voluptatum?

> **Warning**  
> Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aut dignissimos dolorum exercitationem fuga maxime
perspiciatis quae sapiente sunt veniam, voluptat?

For more details, see the GitHub Flavored Markdown documentation.

Contribution Guidelines

If you are submitting documentation for the current stable release, submit it to the corresponding branch. For example, documentation for Mage-OS 2.5.6 would be submitted to the 2.5.6 branch. Documentation intended for the next release of Mage-OS should be submitted to the main branch.

mage0s-devdocs's People

Contributors

adamzero1 avatar aleron75 avatar brentwpeterson avatar cmuench avatar davidlambauer avatar jellesiderius avatar jonashrem avatar mage-os-ci avatar mage-os-terraform[bot] avatar nikolalardev avatar pykettk avatar riconeitzel avatar sprankhub avatar tjitse-e avatar vinai avatar vladyslavsikailo 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.