More than one documentation source in one pipeline run
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- python
- Ambito
- backend, data-engineering
Direzione di ricerca
Read living-doc-utilities/docs/contracts/pipeline-rules.md first to understand the one-source-per-project rule. Then inspect normalize-docs and coverage-matrix for how inputs are handled; the proposed change also depends on a rule change in living-doc-utilities. Done means defining identity, precedence, and provenance across sources, then merging multiple sources in both toolkit components.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Description of Technical Debt
The rule is one project, one pipeline, one documentation source (living-doc-utilities
docs/contracts/pipeline-rules.md), and the toolkit rejects multiple and mixed documentation inputs. Merging two
sources of one project (GitHub issues and Azure DevOps work items, or two collector runs) would need merge logic here
and a rule change in living-doc-utilities.
Impact of Technical Debt
- A project documented in two places needs two pipelines and two documents.
Category
Architecture / Design
Priority
Low - Nice to have
Proposed Solution
When a project needs two sources: the rule change first (identity across sources, precedence, provenance), then merge logic in normalize-docs and coverage-matrix.
Effort Estimate
1-2 weeks
Dependencies / Related
The GitHub Issues and Azure DevOps epics.
Additional Context
Measured 2026-11-12 at living-doc-toolkit fea9aa6 (v0.1.0).
- Lingua principale
- Python
- Stelle
- 0
- Fork
- 0
- Merge medio
- 1g 7h
- PR unite (30g)
- 19
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di AbsaOSS/living-doc-toolkit
-
tech debt
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
AbsaOSS/living-doc-toolkit#120 ·
I maintainer di solito rispondono entro 1 giorno
-
tech debt
Difficoltà 2/5 Mezza giornata Idoneità per principianti 84/100
AbsaOSS/living-doc-toolkit#118 ·
I maintainer di solito rispondono entro 1 giorno
-
tech debt
Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100
AbsaOSS/living-doc-toolkit#116 ·
I maintainer di solito rispondono entro 1 giorno
-
tech debt
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
AbsaOSS/living-doc-toolkit#115 ·
I maintainer di solito rispondono entro 1 giorno
-
tech debt
Difficoltà 4/5 1-2 giorni Idoneità per principianti 55/100
AbsaOSS/living-doc-toolkit#119 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di AbsaOSS/living-doc-toolkit
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
gorakhargosh/watchdog#1462 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 85/100
openwisp/openwisp-monitoring#889 ·
I maintainer di solito rispondono entro 2 giorni
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
OpenFreeEnergy/Lomap#180 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
roman-corgi/corgisim#327 ·
I maintainer di solito rispondono entro 2 giorni
-
agent:WSL bug code-review linux pri:medium sev:low tooling
Difficoltà 2/5 Mezza giornata Idoneità per principianti 62/100
I maintainer di solito rispondono entro 1 giorno