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

Architecture: punt all git concerns to DMC GitSync

Abierto
  • ¿Algo no está bien?
#61 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
45/100
Tipo de issue
Refactorización
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
git, php
Área
backend

Línea de trabajo

Comienza revisando la hoja de ruta de MDI y buscando en el repositorio cualquier uso externo de git o primitivas de git. Se considera completado cuando el trabajo de git auto-commit está ausente de la hoja de ruta, todas las operaciones de git existentes están identificadas para su extracción y el trabajo futuro de vigilancia de archivos está claramente separado de las responsabilidades de DMC GitSync.

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

Descripción

Statement

Markdown Database Integration should not implement git operations. All git concerns (remotes, pull, push, bind, auth, conflict resolution) belong in the separate Data Machine Code GitSync module, which shipped this layer on 2026-04-20.

This issue exists to formalize that boundary so future contributors don't reach for git primitives inside MDI.

Layering

┌─────────────────────────────────────────────────┐
│ DMC GitSync                                     │
│   bind / pull / push / submit / status / policy │  ← ALL git concerns
│   GitHub Contents + Git Data APIs               │
│   (no shell, no git binary, no .git/ directory) │
└─────────────────────────────────────────────────┘
                      ▲
                      │ points at wp-content/markdown/
                      │
┌─────────────────────────────────────────────────┐
│ Markdown Database Integration                   │
│   WP post ↔ .md file on disk                    │  ← filesystem stops here
│   frontmatter / loader / write engine / index   │
└─────────────────────────────────────────────────┘
                      ▲
                      │
┌─────────────────────────────────────────────────┐
│ WordPress (posts, meta, options)                │
└─────────────────────────────────────────────────┘
  • MDI's job: WordPress post ↔ markdown file on disk. Full stop.
  • GitSync's job: markdown file on disk ↔ upstream git repo.
  • Integration: GitSync writes files; MDI notices (via file-watching, not git).

What stays in MDI

  • File watching / filesystem reactivity — detecting new or changed .md files and rehydrating the post index. This is incremental-sync plumbing, not a git concern.
  • Frontmatter round-trip, slug derivation, ID assignment (see #42).
  • The markdown ↔ block conversion pipeline.

What moves out (or was never MDI's in the first place)

  • git commit / git push / git pull / git status — DMC GitSync.
  • Remote repo configuration and auth — DMC GitSync.
  • Branch / worktree management — DMC GitSync.
  • Conflict resolution semantics — DMC GitSync.
  • PR creation for wiki-content syncs — DMC GitSync's submit ability.

Why this matters

MDI must work identically across environments:

  • Self-hosted with DMC + GitSync installed
  • Studio local dev (symlinked MDI checkouts, no DMC)
  • WP.com / VIP (no drop-ins, no DMC)
  • Minimal installs with only MDI

Coupling MDI to git primitives would produce two code paths — one for "git is available" and one for "git isn't" — which is exactly the class_exists() branching the ecosystem explicitly forbids inside feature flows. Users on managed hosts would get a subtly different MDI than self-hosters.

Keeping git in GitSync makes MDI portable, and makes GitSync swappable (the same markdown/ directory could be synced by any alternative implementation — Meilisearch-based sync, inotify-based local mirror, a Dropbox-style agent, etc.).

Action items

  • Confirm current MDI roadmap does not list "git auto-commit" or similar. If it does, remove it.
  • If any code inside MDI currently shells out to git, extract it. (Spot-check says no, but double-check.)
  • Future "file watching" work (fs_events, inotify, polling) lands in MDI. Future "sync this dir with GitHub" work lands in DMC GitSync.

References

  • DMC GitSync shipped: data-machine-code#38, PR #42, #43
  • DMC GitSync is API-first (GitHub Contents + Git Data APIs) — works on WP.com Business, WP Engine, Pantheon, etc.
Lenguaje dominante
PHP
Estrellas
7
Forks
1
Merge medio
1 h 35 min
PR fusionados (30 d)
19

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 Automattic/markdown-database-integration

Todos los issues de Automattic/markdown-database-integration

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.