Skip to content

Commit 046bb71

Browse files
MehulBatrapolyzos
authored andcommitted
[website] create a seperate page for bug report & feature request (apache#1213)
* Create a seperate page for bug report & feature request * change wordings * address giannis comments * address jark comments * address giannis comment
1 parent df726e1 commit 046bb71

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Bug Reports and Feature Requests
3+
sidebar_position: 1
4+
---
5+
6+
<!--
7+
Licensed to the Apache Software Foundation (ASF) under one
8+
or more contributor license agreements. See the NOTICE file
9+
distributed with this work for additional information
10+
regarding copyright ownership. The ASF licenses this file
11+
to you under the Apache License, Version 2.0 (the
12+
"License"); you may not use this file except in compliance
13+
with the License. You may obtain a copy of the License at
14+
15+
http://www.apache.org/licenses/LICENSE-2.0
16+
17+
Unless required by applicable law or agreed to in writing, software
18+
distributed under the License is distributed on an "AS IS" BASIS,
19+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20+
See the License for the specific language governing permissions and
21+
limitations under the License.
22+
-->
23+
24+
# Bug Reports and Feature Requests
25+
26+
You can report an issue in the [Fluss issue tracker](https://github.com/apache/fluss/issues).
27+
28+
## Issue Reporting Guide
29+
30+
Considerations before opening an issue:
31+
32+
- Make sure that the issue corresponds to a genuine bug or enhancement request. Exceptions are made for typos in documentation files, which can be reported directly.
33+
34+
- Provide a clear and descriptive title. Use component labels (such as `component=server`, `component=client`, `component=connector`, `component=docs`) to help categorize your issue and make it easier to filter and search.
35+
36+
- Fill out the issue template to describe the problem or enhancement clearly. Please describe it such that maintainers understand the context and impact from the description, not only from reproduction steps.
37+
38+
- Make sure that you have searched existing issues to avoid duplicates.
39+
40+
- Each issue should address only one problem or enhancement, not mix up multiple unrelated topics.
41+
42+
## Looking for what to report
43+
44+
- If you have encountered a bug, you can proceed to [the bug reporting process](https://github.com/apache/fluss/issues/new?template=bug.yml).
45+
- If you have a feature idea, you can proceed to [the feature request process](https://github.com/apache/fluss/issues/new?template=feature.yml).
46+
47+
## How to report a bug
48+
49+
When filing an issue, make sure to answer these five questions:
50+
51+
**Environment:**
52+
1. What version of Fluss are you using?
53+
2. What operating system and processor architecture are you using?
54+
55+
**Steps to reproduce:**
56+
3. What did you do?
57+
58+
**Expected vs Actual behavior:**
59+
4. What did you expect to see?
60+
5. What did you see instead?
61+
62+
Troubleshooting questions should be posted on:
63+
* [Slack (#troubleshooting)](https://join.slack.com/t/fluss-hq/shared_invite/zt-33wlna581-QAooAiCmnYboJS8D_JUcYw)
64+
* [GitHub Discussions](https://github.com/apache/fluss/discussions)
65+
66+
## How to suggest a feature or enhancement
67+
68+
Fluss aims to provide a unified streaming storage for real-time analytics, offering seamless data ingestion, processing, and querying capabilities with strong consistency guarantees and efficient storage management.
69+
70+
If you're looking for a feature that doesn't exist in Fluss, you're probably not alone. Others likely have similar needs. Please open a [GitHub Issue](https://github.com/apache/fluss/issues/new) describing the feature you'd like to see, why you need it, and how it should work.
71+
72+
When creating your feature request, start by clearly documenting your requirements and avoid jumping straight to implementation details. For substantial features or architectural changes that need broader community input, consider submitting a [Fluss Improvement Proposal (FIP)](https://cwiki.apache.org/confluence/display/FLUSS/Fluss+Improvement+Proposals). FIPs offer a formal process to propose, discuss, and document significant project enhancements.

0 commit comments

Comments
 (0)