docs: add contribution guidelines

CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing to XDEFI Documentation
+## Introduction
+
+This document is a set of guidelines for contributing to this project. These are guidelines, not rules. This guide is meant to make it easy for you to get involved.
+
+First off, thank you for considering contributing to this project. It's people like you that make this documentation better for everyone.
+
+Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open-source project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.
+
+XDEFI Technologies is a community-driven project, and we welcome contributions from the community. Whether you're fixing a typo, adding a new feature, or changing the documentation, we'd love to have your contributions.
+
+Please, don't use the issue tracker for personal support requests. Instead, use the [XDEFI Discord](https://discord.gg/xdefi) for support.
+
+## Ground Rules
+
+Responsibilities
+
+- Ensure cross-platform compatibility for every change that's accepted. Windows, Mac, Debian, Ubuntu Linux.
+- Create issues for any major changes and enhancements that you wish to make. Discuss things transparently and get community feedback.
+- Don't add any classes to the CSS that you're not using.
+- Be welcoming to newcomers and encourage diverse new contributors from all backgrounds.
+- Keep feature versions as small as possible, preferably one new feature per version.
+- Be welcoming to newcomers and encourage diverse new contributors from all backgrounds.
+
+## Contribution workflow
+
+1. Search for an existing issue or create a new one to start a discussion around your idea or bug. Make sure no one else is already working on it, and assign yourself to the issue if you plan to work on it. If you don't have permissions to assign yourself, leave a comment asking for it.
+2. Clone the repository to your local machine.
+3. Create and checkout a new branch for your work, naming it relevantly. We recommend naming your branch with the issue number and a short description of the issue (e.g., `issue-123-fix-typo`), which is a reminder to fix only one issue in a PR.
+4. Open the project in your favorite editor and start making your changes.
+5. Commit your changes, briefly describing what you did in the commit message. Push your changes to your branch.
+6. On this repository, navigate to the "Pull Requests" tab and click on "New Pull Request". Describe your changes in detail, including the issue number you're addressing. If you're not ready for a review yet, you can open a draft pull request.
+7. Specific reviewers will be assigned to your pull request. If you don't get a response within a week, feel free to ask for a review in the Discord channel.
+8. Make changes to your pull request if the reviewer asks for them. Once the reviewer approves your changes, the pull request will be merged.
+
+## Code review process
+
+The core team looks at Pull Requests on a regular basis in a weekly triage meeting that we hold in Discord. The meeting is used to discuss Pull Requests and Issues. The meeting is open to the public, and you are welcome to join.
+
+After feedback has been given, the Pull Request author should respond within a week. After a week with no response, the Pull Request may be closed.
+
+## How to report a bug
+
+If you find a security vulnerability, do NOT open an issue. Email [[email protected]](mailto:[email protected]) instead.
+
+When filing an issue, make sure to answer these five questions:
+
+1. What version of the documentation are you using?
+2. What did you do?
+3. What did you expect to see?
+4. What did you see instead?
+5. What operating system are you using?
+
+## How to suggest a feature or enhancement
+
+If you find yourself wishing for a feature that doesn't exist in the documentation, you are probably not alone. There are bound to be others out there with similar needs. Many of the features that exist in the documentation started as a pull request from a single contributor.
+
+When suggesting a feature, please provide as much detail as possible. Explain what the feature would do and how it would be useful to other users.
+
+## Community
+
+Discussions about the documentation take place on the [XDEFI Discord](https://discord.gg/xdefi).
+
+We also available on [X](https://twitter.com/xdefi_wallet) and [Telegram](https://t.me/xdefi_announcements).
+
+## Code of Conduct
+
+Please note that this project is released with a Contributor Code of Conduct. By participating in this project, you agree to abide by its terms.

README.md

@@ -27,19 +27,21 @@ improving content clarity, or adding new topics, every contribution helps.
 - Push & Create PR: Push your changes to your fork and create a pull request
   to the main branch of this repository.
 
-Please ensure to review the detailed Contribution Guidelines above before
+Please ensure to review the detailed [Contribution Guidelines](./CONTRIBUTING.md) before
 making a pull request.
 
 ## Directory Structure
 
 - /.vitepress: Configuration files for the VitePress site.
+- /assets: Images, diagrams, and other media files used in the documentation.
 - /about: A category for learning more about XDEFI Technologies and $XDEFI token.
 - /campaigns: A category for Campaigns Service API
+- /assets-service: A category for Assets Service API
 - /developers: A category with tutorials and guides for deploying
   dApps and connect with XDEFI Wallet.
 - /routing: Technical reference materials for integrating our Routing aggregator API.
-- /public: Images, diagrams, and other media files used in the documentation.
-- /components: Custom components used in the documentation.
+- /public: Static assets like images, diagrams, and other media files.
+- /components: Custom React components integrated into the documentation.
 
 ## Feedback & Suggestions
 

about/xdefi-technologies/audits.md

@@ -9,7 +9,7 @@ _Note that we will always recommend you for more security to use one of our [sup
 We continuously try to improve our security by having audits from different providers. The list below retrieve all the previous audits made:
 
 - I don't remind - 2020
-- [Kudelski Security audit]() - 2021
+- Kudelski Security audit - 2021
 - New one - 2024
 
 As of 2024, we are open sourcing part of our repositories. We encourage users, developers and security researchers to help us maintaining the best level of security, and report us any finding using our [bug bounty program](./bug-bounty-program)

about/xdefi-technologies/change-custom-rpc.md

@@ -0,0 +1 @@
+# How to change a Custom RPC

about/xdefi-technologies/native-integration.md

@@ -32,9 +32,9 @@
 
 The others **EVM's blockchains** are [supported non natively](./custom-integration) using Custom Network integration, allowing users and developers to interact and build on them.
 
-See more on [Adding a custom EVM network on XDEFI](./how-to-add-custom-network) documentation.
+See more on [Adding a custom EVM network on XDEFI](./add-custom-network) documentation.
 
-See more on [Building an EVM dApp](/developers/build-evm-dapp) with XDEFI documentation.
+See more on [Building an EVM dApp](/developers/ethereum) with XDEFI documentation.
 
 You can request an EVM native integration by sending us an [email](mailto:[email protected]).
 
@@ -59,9 +59,9 @@ _(Note that native integration requiere an upfront payment to start implementing
 
 The others **Cosmos chains** are [supported non natively](./custom-integration) using Custom Network integration, allowing users and developers to interact and build on them.
 
-See more on [Adding a custom Cosmos network on XDEFI](./how-to-add-custom-network) documentation.
+See more on [Adding a custom Cosmos network on XDEFI](./add-custom-network) documentation.
 
-See more on [Building a Cosmos dApp](/developers/build-cosmos-dapp) with XDEFI documentation.
+See more on [Building a Cosmos dApp](/developers/cosmos) with XDEFI documentation.
 
 You can request a Cosmos native integration by sending us an [email](mailto:[email protected]).
 
@@ -71,10 +71,10 @@ _(Note that native integration requiere an upfront payment to start implementing
 
 - Near Protocol (NEAR)
 
-See more on [Building a Near dApp](/developers/build-near-dapp) with XDEFI documentation.
+See more on [Building a Near dApp](/developers/near) with XDEFI documentation.
 
 ## Solana
 
 - Solana (SOL)
 
-See more on [Building a Solana dApp](/developers/build-solana-dapp) with XDEFI documentation.
+See more on [Building a Solana dApp](/developers/solana) with XDEFI documentation.