docs: clarify development feature flag documentation

amimas · amimas · commit b41e3a1e8d41 · 2026-03-15T17:53:35.000-04:00
The existing documentation for `features.rst` covered the API for
managing GitLab's internal development feature flags, which requires
administrator access. This was easily confused with the newly added
project-level feature flags API.

To prevent ambiguity for users, this commit refactors the documentation by:
- Renaming `features.rst` to `gitlab_features.rst`.
- Updating the title and adding a note to clarify its specific,
  admin-only purpose.
- Adding a cross-reference to the new project-level feature flag
  documentation.
diff --git a/docs/api-objects.rst b/docs/api-objects.rst
@@ -24,7 +24,7 @@ API examples
    gl_objects/environments
    gl_objects/events
    gl_objects/epics
-   gl_objects/features
+   gl_objects/gitlab_features
    gl_objects/geo_nodes
    gl_objects/groups
    gl_objects/group_access_tokens
diff --git a/docs/gl_objects/gitlab_features.rst b/docs/gl_objects/gitlab_features.rst
@@ -1,6 +1,11 @@
-##############
-Features flags
-##############
+################################
+GitLab Development Feature Flags
+################################
+
+.. note::
+
+   This API is for managing GitLab's internal development feature flags and requires administrator access.
+   For project-level feature flags, see :doc:`project_feature_flags`.
 
 Reference
 ---------
@@ -11,7 +16,7 @@ Reference
   + :class:`gitlab.v4.objects.FeatureManager`
   + :attr:`gitlab.Gitlab.features`
 
-* GitLab API: https://docs.gitlab.com/api/features
+* GitLab API: https://docs.gitlab.com/ee/api/features.html
 
 Examples
 --------
@@ -29,4 +34,4 @@ Create or set a feature::
 
 Delete a feature::
 
-    feature.delete()
+    feature.delete()
