Pittore della conoscenza

Trasformare la documentazione dello sviluppatore in video precisi

Scarica la documentazione API, cambiamenti, note di integrazione, diagrammi architettoniche e altre documentazioni dello sviluppatore per generare video che mostrano i percorsi di richiesta, il comportamento del sistema, i cambiamenti di versione e i punti di revisione.

Utilizzare una sequenza visiva per spiegare un percorso del sistema

Per chi è per

  • Gruppi di relazioni di sviluppatore

    Hai bisogno di una spiegazione che fornisce una nuova orientazione per gli sviluppatori prima di navigare sul set completo della documentazione.

    • Le squadre di DevRel
    • Sostenitori degli sviluppatori
    Documenti tipici:API DocchiDiagrammi di architettura
  • Team di prodotto e di ingegneria

    Vuoi che un cambiamento di rilascio o di integrazione sia più facile da comunicare tra le persone che possiedono parti diverse del sistema.

    • Responsabili di prodotto
    • Squadre di ingegneria
    Documenti tipici:CancelloniNota di integrazione

Preparate i vostri documenti

Inizia con la fonte in cui ti fidi

Trasformare la documentazione dello sviluppatore come docchi API, diagrammi di architettura, cambiamenti e note di integrazione in video le persone possono seguire e rivedere.

  • La documentazione dello sviluppatore
  • Documentazione API
  • Diagrammi di architettura
  • Cancelloni
  • Nota di integrazione

Prima di iniziare

  • Utilizzare la versione corrente, completa
  • Segnalare le sezioni, i passaggi, i grafici o le figure che meritano il focus
  • Identificare i termini, i numeri, gli avvertimenti o il testo che devono rimanere

Un percorso focalizzato

Spiegare il percorso, non solo i nomi dei punti finali

  1. 1

    Nome della domanda del visitatore

    Metti l'obiettivo dello sviluppatore, il rapporto di sistema che hanno bisogno di capire, e la versione attuale o il limite che importa.

  2. 2

    La fonte che porta i dettagli

    Aggiungi la fonte corrente e nominare le sezioni, termini, figure o passaggi che l'interpretazione deve preservare.

  3. 3

    Riflessioni sul contesto di utilizzo

    Avere l'API o il proprietario del prodotto verifica la terminologia, il comportamento di campione, le referenze di versione e i confini sensibili alla sicurezza prima di condividere.

Utile il prossimo passo

Utilizzare una risorsa o un caso che corrisponde a questo compito

Utilizza uno script supportato dal codice sorgente per rendere visibile un percorso tecnico

FAQ

Crea il tuo primo video esplicativo