⚡️ Official Lazerpay Finance documentation and API reference manual
Welcome to Lazerpay Official Documentation 👋
This is the repository for the Lazerpay documentation site [docs.lazerpay.finance][wi]. Lazerpay Documentation accepts contributions via GitHub pull requests. This document outlines some contributing guidelines, contact points, and other resources to make it easier to contribute to lazerpay-documentation-v2.
If you've run into a problem or have a suggestion, browse the open [issues][is] before opening a new one. We use the following [label system][la] to organize our issues.
- ![][cr] for typos, broken links, and other quick fixes
- ![][tr] for additions to the FAQ and Troubleshooting sections
- ![][im] for revisions, rewrites, and larger improvements
- ![][fe] for feedback on structure & content
- ![][qu] for questions that can't be answered via documentation
- ![][fi] for improvements and fixups related to the look and feel of the docs
Best practices for managing contributions
- If a question is asked more than twice in the documentation channel, it should be
- If a piece of unaddressed feedback is given more than three times, a ![][fe]
- Issues will be reviewed on a rolling basis and triaged weekly by
How to Contribute
Get Started
- Create a fork of the documentation, install neccessary dependencies by running
yarn - To start your server, run
yarn devand you'll have your development server running on localhost:3000
Editing Content
To add a new content, e.g page, please note this is a NextJS app, a knowledge of NextJS is required to work with files and how pages are routed.- All new pages should go to the
content/docsfolder accordingly. The pages are written in markdown (MDX - an extension of MD). - MDX allows you to use JSX components in the same file. If you have a section of the page that is written in JSX, please create that component and include it to the existing mdx-component object so it is properly mapped when rendering. Don't forget to export the component in the entry
index.tsfile before importing anywhere else. - UI Reusable components like
LzButton,LzLinkandLzContainercan be found in UI-Components. Use these components when working on any issue. You're welcome to create new UI reusable components in the same project folder. Please make sure your new resuable components follow the same naming convention as the existing components. - Tailwindcss helps you to build any design, directly in your markup. We implement this css framework in our components, so knowledge of Tailwind is required. Please go through the Typography-scss-file to understand how to apply the existing typography in our design pattern. Also, see Tailwind-config for the list of our colors, shadows, font sizes, etc. Check out Quicklinks for a sample of how these are implemented.
Editing an existing docs page
- Make your changes to the neccessary files, create your PR following the issue guideline
Adding a new docs page to an existing sidebar
- The sidebar is quite easy to use. After creating your page, update the
sidebar.config.tsfile to include your new route/page if it's not already there. Each sidebar option has a nested structure, so if you are working on a nested link under a particular sidebar item, add that page route in theitemsarray of the sidebar config.
Contributing
Contributions to lazerpay-documentation-v2 can be made via pull requests on GitHub. When opening a PR, please tag any associated parties, @MeisterJustice and @Frontend-io
Contributors ✨
Thanks to Chakra-UI team for making their Zag Docs documentation Open source and free to use.
This project follows the all-contributors specification. Contributions of any kind welcome!
[cr]: https://img.shields.io/badge/-fixup-critical [cs]: https://docs.github.com/en/github/authenticating-to-github/managing-commit-signature-verification/signing-commits [fe]: https://img.shields.io/badge/-feedback-%23DD0BE1 [fh]: https://github.com/LazerPay-Finance/Lazerpay-documentation-v2/projects/1 [fi]: https://img.shields.io/badge/-ui-1d76db [im]: https://img.shields.io/badge/-improvement-blueviolet [is]: https://github.com/LazerPay-Finance/Lazerpay-documentation-v2/issues [la]: https://github.com/LazerPay-Finance/Lazerpay-documentation-v2/labels [qu]: https://img.shields.io/badge/-question-C0EE59 [tr]: https://img.shields.io/badge/-troubleshooting-%23FBCA04 [wi]: https://docs.lazerpay.finance/home/