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

Create a style guide page for plugin developers

Abierto
#190 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
32/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Estancado

Línea de trabajo

Empieza con la guía existente “Contributing to Piwik core” enlazada en el issue e identifica las directrices de estilo que se deben extraer. Crea una guía de estilo independiente para desarrolladores de plugins que cubra los temas de nomenclatura y arquitectura indicados, y enlázala desde la categoría “Develop => Getting started”.

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

Descripción

Documentation
  • Should include naming for common db fields like created_date, updated_date to have this consistent (also reflects later in API calls etc)
  • Common naming for DB tables (eg singular vs plural)
  • Explain Dao vs Models etc.

As it is a lot of work to create such a document I suggest we simply start with a few styles and tweak it over time. Some parts are already defined here: https://developer.piwik.org/guides/contributing-to-piwik-core we would need to extract some of this stuff and put it into a separate document as contributing to Piwik core page is way too long.

Then we can also link to that page from the "Develop => Getting started" category.

Any thoughts @mattab @sgiehl ?

Lenguaje dominante
PHP
Estrellas
58
Forks
88
Merge medio
6 h 29 min
PR fusionados (30 d)
3

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

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 matomo-org/developer-documentation

Todos los issues de matomo-org/developer-documentation

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.