diff --git a/docs/early-access.md b/docs/early-access.md index c15a914b..637d6043 100644 --- a/docs/early-access.md +++ b/docs/early-access.md @@ -15,9 +15,10 @@ Beta features are ready for public testing. - The documentation may be incomplete or outdated. - The changelog may be missing. -- The feature may not be fully stable, but it should give a general idea of the final user experience. +- The feature may not be fully stable. - Edge cases may not be fully covered. -- Some parts of the feature may not be implemented. For example, the GitHub integration may be prioritized over others. +- Some parts of the feature may not be implemented. +- They may not represent the end result of the planned feature and may not have a satisfactory user experience. Whenever you use a beta feature, you may see a warning like this: @@ -32,7 +33,6 @@ Experiments are ways for CodeRabbit's development team to gather more experience - They are highly unstable and may not work at all. - There is no guarantee that they will reach the beta stage and they may be cancelled at any time without any prior notice. - They are not ready for public use and may not be sufficiently documented. -- They do not represent the end result of the planned feature and do not have a satisfactory user experience. - We are not gathering feedback for experiments - the direction they take can vary widely. Whenever you use an experiment, you may see a warning like this: diff --git a/docs/finishing-touches/docstrings.md b/docs/finishing-touches/docstrings.md index 050c4984..587db092 100644 --- a/docs/finishing-touches/docstrings.md +++ b/docs/finishing-touches/docstrings.md @@ -1,6 +1,6 @@ --- title: Docstrings generation with CodeRabbit -sidebar_label: Docstrings (Experiment) +sidebar_label: Docstrings (Beta) description: Automated docstrings pull requests with CodeRabbit --- @@ -9,7 +9,7 @@ description: Automated docstrings pull requests with CodeRabbit Docstrings generation is part of the [finishing touches](/future-developments#finishing-touches) initiative. :::warning -The [docstrings](/finishing-touches/docstrings) feature is [experimental](/early-access#experiments). +The [docstrings](/finishing-touches/docstrings) feature is in [beta](/early-access#beta). ::: ## Usage @@ -40,7 +40,7 @@ The checked software forges are supported: - [x] GitHub - [ ] GitLab -The presence of an unsupported software forge in this list does not constitute a commitment to support it in the future. Remember that the docstrings feature is [experimental](/early-access#experiments). +The presence of an unsupported software forge in this list does not constitute a commitment to support it in the future. Remember that the docstrings feature is in [beta](/early-access#beta). ## Supported languages @@ -66,7 +66,7 @@ The checked languages are supported: - [ ] Swift - [x] TypeScript -The presence of an unsupported language in this list does not constitute a commitment to support it in the future. Remember that the docstrings feature is [experimental](/early-access#experiments). +The presence of an unsupported language in this list does not constitute a commitment to support it in the future. Remember that the docstrings feature is in [beta](/early-access#beta). :::note In the case of JavaScript and TypeScript, there are tons of ways to declare functions. At the moment, we only support the keyword `function` at the top level.