open-webui/docs/CONTRIBUTING.md

62 lines
3.6 KiB
Markdown
Raw Permalink Normal View History

2024-02-17 08:30:38 +01:00
# Contributing to Open WebUI
2024-02-15 19:15:13 +01:00
🚀 **Welcome, Contributors!** 🚀
2024-02-17 08:30:38 +01:00
Your interest in contributing to Open WebUI is greatly appreciated. This document is here to guide you through the process, ensuring your contributions enhance the project effectively. Let's make Open WebUI even better, together!
2024-02-15 19:15:13 +01:00
## 📌 Key Points
2024-02-17 08:30:38 +01:00
### 🦙 Ollama vs. Open WebUI
2024-02-15 19:15:13 +01:00
2024-02-17 08:30:38 +01:00
It's crucial to distinguish between Ollama and Open WebUI:
2024-02-15 19:15:13 +01:00
2024-02-17 08:30:38 +01:00
- **Open WebUI** focuses on providing an intuitive and responsive web interface for chat interactions.
2024-02-15 19:15:13 +01:00
- **Ollama** is the underlying technology that powers these interactions.
2024-02-17 08:30:38 +01:00
If your issue or contribution pertains directly to the core Ollama technology, please direct it to the appropriate [Ollama project repository](https://ollama.com/). Open WebUI's repository is dedicated to the web interface aspect only.
2024-02-15 19:15:13 +01:00
### 🚨 Reporting Issues
2024-02-17 08:30:38 +01:00
Noticed something off? Have an idea? Check our [Issues tab](https://github.com/open-webui/oopen-webui/issues) to see if it's already been reported or suggested. If not, feel free to open a new issue. When reporting an issue, please follow our issue templates. These templates are designed to ensure that all necessary details are provided from the start, enabling us to address your concerns more efficiently.
2024-02-15 19:28:00 +01:00
> [!IMPORTANT]
2024-02-17 08:30:38 +01:00
>
2024-02-15 19:28:00 +01:00
> - **Template Compliance:** Please be aware that failure to follow the provided issue template, or not providing the requested information at all, will likely result in your issue being closed without further consideration. This approach is critical for maintaining the manageability and integrity of issue tracking.
>
> - **Detail is Key:** To ensure your issue is understood and can be effectively addressed, it's imperative to include comprehensive details. Descriptions should be clear, including steps to reproduce, expected outcomes, and actual results. Lack of sufficient detail may hinder our ability to resolve your issue.
2024-02-15 19:15:13 +01:00
### 🧭 Scope of Support
2024-02-17 08:30:38 +01:00
We've noticed an uptick in issues not directly related to Open WebUI but rather to the environment it's run in, especially Docker setups. While we strive to support Docker deployment, understanding Docker fundamentals is crucial for a smooth experience.
2024-02-15 19:15:13 +01:00
2024-02-17 08:30:38 +01:00
- **Docker Deployment Support**: Open WebUI supports Docker deployment. Familiarity with Docker is assumed. For Docker basics, please refer to the [official Docker documentation](https://docs.docker.com/get-started/overview/).
2024-02-15 19:15:13 +01:00
2024-02-17 08:30:38 +01:00
- **Advanced Configurations**: Setting up reverse proxies for HTTPS and managing Docker deployments requires foundational knowledge. There are numerous online resources available to learn these skills. Ensuring you have this knowledge will greatly enhance your experience with Open WebUI and similar projects.
2024-02-15 19:15:13 +01:00
## 💡 Contributing
Looking to contribute? Great! Here's how you can help:
### 🛠 Pull Requests
We welcome pull requests. Before submitting one, please:
2024-02-17 08:30:38 +01:00
1. Discuss your idea or issue in the [issues section](https://github.com/open-webui/open-webui/issues).
2024-02-15 19:15:13 +01:00
2. Follow the project's coding standards and include tests for new features.
3. Update documentation as necessary.
4. Write clear, descriptive commit messages.
### 📚 Documentation & Tutorials
2024-02-17 08:30:38 +01:00
Help us make Open WebUI more accessible by improving documentation, writing tutorials, or creating guides on setting up and optimizing the web UI.
2024-02-15 19:15:13 +01:00
### 🤔 Questions & Feedback
Got questions or feedback? Join our [Discord community](https://discord.gg/5rJgQTnV4s) or open an issue. We're here to help!
## 🙏 Thank You!
2024-02-17 08:30:38 +01:00
Your contributions, big or small, make a significant impact on Open WebUI. We're excited to see what you bring to the project!
2024-02-15 19:15:13 +01:00
Together, let's create an even more powerful tool for the community. 🌟