Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
#14,655 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@xhon-pelushi ya está trabajando en esto.

Desde el 13/8/2026.

  • #15448 de @xhon-pelushi — abierto

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Tranquilo
Stack tecnológico
openapi

Línea de trabajo

Abre la página enlazada de documentación de OCS OpenAPI y busca la sección en la que se describe ApiController o su clase principal. Añade el requisito de que el nombre de la clase principal debe terminar en OCSController, con una explicación de por qué extender OCSController indirectamente puede producir de lo contrario un error poco claro. La tarea estará terminada cuando el tutorial haga explícita esta restricción de nomenclatura.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
JavaScript
Estrellas
633
Forks
2.6k
Merge medio
16 h 42 min
PR fusionados (30 d)
121

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de nextcloud/documentation

Todos los issues de nextcloud/documentation

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.