Move plugin-architecture Piped usage guide to official documentation

Aperta
#6,742 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

@A-d-i-t-y ci sta già lavorando.

Dal 17/5/2026.

  • #6785 di @A-d-i-t-y — chiusa senza merge

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
68/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
hugo
Ambito
documentation

Direzione di ricerca

Inizia leggendo cmd/pipedv1/README-usage-alpha.md e le pagine correlate in docs/content/en/docs-v1.0.x/installation/install-piped/. Sposta le sezioni Prerequisites, Setup Control Plane, Run Piped e Deploy an Application in plugin-architecture.md, aggiorna i link interni e l'avviso alpha, quindi trasforma la README in un puntatore alla nuova pagina. Il lavoro è completo quando il contenuto è individuabile nella documentazione ufficiale, usa una formattazione Hugo coerente e contiene link funzionanti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

kind/enhancement

*What would you like to be added:

Move the plugin-architecture Piped usage guide from:

cmd/pipedv1/README-usage-alpha.md

to the official documentation under:

docs/content/en/docs-v1.0.x/installation/install-piped/plugin-architecture.md

This would include:

  • Migrating all relevant sections (Prerequisites, Setup Control Plane, Run Piped, Deploy an Application)
  • Replacing the "alpha" notice with a proper Hugo alert block
  • Updating internal links to align with documentation pages
  • Converting the existing README into a pointer to the new documentation

Why is this needed:

  • Improves discoverability, as users typically look for installation guidance in the official docs/ directory rather than inside cmd/
  • Provides a more structured and complete documentation experience
  • Reduces maintenance overhead by leveraging Hugo-based docs (versioning, search, consistent styling)
  • Improves onboarding for new users and contributors by centralizing important usage instructions
Lingua principale
Go
Stelle
1.4k
Fork
391
Merge medio
4g 1h
PR unite (30g)
58

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di pipe-cd/pipecd

Tutte le issue di pipe-cd/pipecd

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.