Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

OCS OpenAPI tutorial: Mention that the parent class of the API has to end with OCSController

Đang mở Phù hợp với người mới
#14,655 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@xhon-pelushi đang làm issue này rồi.

Từ ngày 13/8/2026.

  • #15448 của @xhon-pelushi — đang mở

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
78/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
openapi
Lĩnh vực
documentation

Hướng nghiên cứu

Mở trang tài liệu OCS OpenAPI được liên kết và tìm phần mô tả ApiController hoặc lớp cha của nó. Thêm yêu cầu rằng tên lớp cha phải kết thúc bằng OCSController, kèm theo cách diễn đạt giải thích rằng nếu không, việc mở rộng OCSController một cách gián tiếp có thể tạo ra lỗi không rõ ràng. Hoàn thành khi tutorial nêu rõ ràng ràng buộc đặt tên này.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

1. to develop good first issue
Before You Submit
  • I have checked for existing issues and pull requests related to my suggestion.
  • I have posted on the Nextcloud Community Help Forum if my suggestion is a troubleshooting scenario or I'm unsure about the solution.
Type of Suggestion

Mention that the name of the parent class of the ApiController has to end with OCSController.

Relevant Documentation Links

https://docs.nextcloud.com/server/latest/developer_manual/client_apis/OCS/ocs-openapi.html

Additional Notes

I got mad about this, because I had a baseApiV2Controller class (now renamed baseApiV2Controller) until I stumbled over the comment inside the OpenAPIExtractor. I did not understand the error message, because I was extending OCSController, but inside the parent class.

Ngôn ngữ chính
JavaScript
Star
633
Fork
2.6k
Merge trung bình
22 giờ 40 phút
Pull request đã merge (30 ngày)
93

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của nextcloud/documentation

Tất cả issue của nextcloud/documentation

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.