Developer Guide
===============

Welcome to the **CyMaIS Developer Guide**! This guide provides essential information for developers who want to contribute to the CyMaIS open-source project.

Explore CyMaIS Solutions
------------------------
CyMaIS offers various solutions for IT infrastructure automation. Learn more about the available applications:

- :doc:`../../../roles/application_glosar`
- :doc:`../../../roles/application_categories`

For Developers
--------------

Understanding Ansible Roles
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

CyMaIS is powered by **Ansible** roles to automate deployments. Developers can explore the technical details of our roles here:

- :doc:`../../../roles/ansible_role_glosar`

Contributing to CyMaIS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Want to contribute to the project or explore the source code? Check out our **GitHub repository**:

- `CyMaIS GitHub Repository <https://github.com/kevinveenbirkenbach/cymais/tree/master/roles>`_

Contribution Guidelines
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

1. **Fork the Repository** – Start by forking the CyMaIS repository.
2. **Create a New Branch** – Make changes in a dedicated branch.
3. **Follow Coding Standards** – Ensure your code is well-documented and follows best practices.
4. **Submit a Pull Request** – Once your changes are tested, submit a PR for review.

For detailed guidelines, refer to:

- :doc:`../../../CONTRIBUTING`
- :doc:`../../../CODE_OF_CONDUCT`

Community & Support
-------------------
If you have questions or need help, visit the **CyMaIS Information Hub**:

- `hub.cymais.cloud <https://hub.cymais.cloud>`_

This is the best place to ask questions, get support, and collaborate with other contributors.

Stay connected, collaborate, and help improve CyMaIS together!

Happy coding! 🚀