From 2fda8b387c1440d0698ce3b20c0661281defefc0 Mon Sep 17 00:00:00 2001 From: Kevin FEDYNA Date: Tue, 28 Jan 2025 21:15:24 +0100 Subject: [PATCH] Added FAQ and other pages (blank for now) --- CLI.md | 0 Contributing.md | 0 FAQs.md | 100 ++++++++++++++++++++++++++++++++++++++++++++++++ Installation.md | 2 +- Modules.md | 2 +- Releases.md | 0 Tutorials.md | 0 7 files changed, 102 insertions(+), 2 deletions(-) create mode 100644 CLI.md create mode 100644 Contributing.md create mode 100644 FAQs.md create mode 100644 Releases.md create mode 100644 Tutorials.md diff --git a/CLI.md b/CLI.md new file mode 100644 index 0000000..e69de29 diff --git a/Contributing.md b/Contributing.md new file mode 100644 index 0000000..e69de29 diff --git a/FAQs.md b/FAQs.md new file mode 100644 index 0000000..4606ad8 --- /dev/null +++ b/FAQs.md @@ -0,0 +1,100 @@ +# FAQs ❓ + +Welcome to the **Frequently Asked Questions (FAQs)** page for PolyMPR! Here, you'll find answers to common questions about the platform, its features, and how to use it effectively. If you don't find what you're looking for, feel free to reach out to the community or consult the [documentation](https://github.com/fedyna-k/PolyMPR/wiki). 🛠️ + +## General Questions 🌐 + +### 1. **What is PolyMPR?** +PolyMPR (Poly Management Platform for Resources) is a **Deno/Fresh-based framework** designed to help the INFO department transition to cloud-based HR management. It uses a **modulith architecture** to ensure flexibility, scalability, and ease of maintenance. + +### 2. **Who is PolyMPR for?** +PolyMPR is tailored for the **Polytech departments**, more specifically INFO department, looking to modernize their HR systems and transition to the cloud. + +### 3. **What are the key features of PolyMPR?** +PolyMPR offers: +- **Modulith architecture** for easy customization and scalability. +- **Cloud-native design** for seamless integration with cloud services. +- **Deno and Fresh framework** for secure, fast, and modern web applications. + +### 4. **Is PolyMPR open-source?** +Yes! PolyMPR is **open-source** and released under the **MIT License**. You can view, modify, and distribute the code as per the license terms. + +## Installation and Setup 🛠️ + +### 5. **How do I install PolyMPR?** +To install PolyMPR, clone the GitHub repository and follow the [installation guide](./installation). You’ll need **Deno** and optionally **Docker** for containerized deployments. + +```bash +git clone https://github.com/PolyMPR/PolyMPR.git +cd PolyMPR +deno task start +``` + +### 6. **Do I need to install Deno separately?** +No, Deno is not required to run PolyMPR if you run it with Docker compose. But you can install it using the official [Deno installation guide](https://deno.land/#installation). + +### 7. **Can I use Docker with PolyMPR?** +Absolutely! Docker is optional but recommended for containerized deployments. Use the provided `compose.yml` file to build and run the application. + +```bash +docker compose up --build +``` + +## Modules and Customization 🧩 + +### 8. **What are modules in PolyMPR?** +Modules are self-contained units of functionality that can be added, removed, or updated independently. Examples include **Grade management** and **Student signatures**. + +### 9. **How do I create a new module?** +To create a new module, follow the [module creation guide](./modules). Each module must be placed in the `routes/(apps)/` folder and follow the specified structure. + +### 10. **Can I customize existing modules?** +Yes! PolyMPR’s modular design makes it easy to customize existing modules. Simply modify the relevant files in the module’s folder. + +### 11. **How do I add a new feature to PolyMPR?** +You can add new features by creating a custom module or extending an existing one. + +## Troubleshooting 🛠️ + +### 12. **I’m getting a permission error when running PolyMPR. What should I do?** +Deno requires explicit permissions to access files, networks, and environments. Run the application with the necessary flags: + +```bash +deno run --allow-net --allow-read --allow-env main.ts +``` + +### 13. **Docker isn’t working. What could be the issue?** +Ensure Docker is installed and running on your system. Check the logs for errors and verify that you have sufficient resources (e.g., memory and CPU) allocated. + +### 14. **I can’t access the application at `https://localhost`. What’s wrong?** +Make sure the application is running and there are no errors in the terminal. If you’re using Docker, ensure the container is up. + +## Community and Support 🤝 + +### 15. **Where can I get help if I’m stuck?** +You can: +- Join the [GitHub Discussions](https://github.com/PolyMPR/discussions) to ask questions and share ideas. +- Report issues on the [Issue Tracker](https://github.com/PolyMPR/issues). +- Consult the [documentation](https://github.com/fedyna-k/PolyMPR/wiki) for detailed guides and tutorials. + +### 16. **How can I contribute to PolyMPR?** +We welcome contributions! Check out the [contributing guide](/contributing) to learn how to submit pull requests, report issues, or suggest new features. + +### 17. **Is there a community forum or chat for PolyMPR?** +Yes! Join the [PolyMPR Discord server]() to connect with other users and developers. + +## Licensing and Usage 📜 + +### 18. **What license is PolyMPR released under?** +PolyMPR is open-source and released under the **MIT License**. You’re free to use, modify, and distribute the code as per the license terms. + +## Next Steps 🚀 + +If you didn’t find the answer to your question here, check out the following resources: +- **[Installation Guide](./installation)**: Learn how to set up PolyMPR on your local machine to start development. 🖥️ +- **[Modules](./modules)**: Learn how to create modules in PolyMPR. 🧩 +- **[Tutorials](./tutorials)**: Step-by-step guides to help you get the most out of PolyMPR. 🎓 +- **[CLI Documentation](./cli)**: Dive into the technical details of PolyMPR's CLI. 📄 +- **[Release Notes](./releases)**: Stay up-to-date with the latest features and improvements. 📰 + +Thank you for using PolyMPR! If you have additional questions, feel free to reach out to the community. Happy coding! 💻✨ \ No newline at end of file diff --git a/Installation.md b/Installation.md index 5213693..9ab540c 100644 --- a/Installation.md +++ b/Installation.md @@ -76,4 +76,4 @@ Now that you've successfully installed PolyMPR, you're ready to start exploring - **[FAQs](./faqs)**: Find answers to common questions about PolyMPR. ❓ - **[Release Notes](./releases)**: Stay up-to-date with the latest features and improvements. 📰 -Thank you for installing PolyMPR! If you have any questions or need further assistance, feel free to reach out to the community or consult the [FAQs](/faqs). Happy coding! 💻✨ \ No newline at end of file +Thank you for installing PolyMPR! If you have any questions or need further assistance, feel free to reach out to the community or consult the [FAQs](./faqs). Happy coding! 💻✨ \ No newline at end of file diff --git a/Modules.md b/Modules.md index 4233c76..4edb715 100644 --- a/Modules.md +++ b/Modules.md @@ -98,4 +98,4 @@ Now that you know how to create modules, you can start building and customizing - **[FAQs](./faqs)**: Find answers to common questions about PolyMPR. ❓ - **[Release Notes](./releases)**: Stay up-to-date with the latest features and improvements. 📰 -Thank you for installing PolyMPR! If you have any questions or need further assistance, feel free to reach out to the community or consult the [FAQs](/faqs). Happy coding! 💻✨ \ No newline at end of file +Thank you for installing PolyMPR! If you have any questions or need further assistance, feel free to reach out to the community or consult the [FAQs](./faqs). Happy coding! 💻✨ \ No newline at end of file diff --git a/Releases.md b/Releases.md new file mode 100644 index 0000000..e69de29 diff --git a/Tutorials.md b/Tutorials.md new file mode 100644 index 0000000..e69de29