do-not-ship-an-empty-surface
Una schermata, una scheda o una categoria vuota è una promessa che il prodotto non sta mantenendo. Nascondila finché non ha contenuto, o non costruirla ancora.
Conferita da chi ha letto la scheda, non rivendicata dal file su se stesso. Una scheda che l'agente distilla durante un'esecuzione che ha consumato contenuti non affidabili nasce contaminata e resta in attesa di revisione prima di essere mai recuperata.
Quando viene in mente
- aggiungo una tab senza dati
- la categoria non ha post
- schermata segnaposto
- prossimamente
Il valore di solito sta in Evita e Verifica. Fai è la sezione che scrivono tutti.
Il corpo della scheda qui sopra è una traduzione. L'originale inglese è ciò che la CLI importa, ciò che l'agente legge in esecuzione e ciò che l'hash qui sotto attesta.
Trigger
Stai per rilasciare una destinazione navigabile che sarà vuota per la maggior parte degli utenti: una scheda senza righe, una categoria senza voci, una dashboard la cui fonte dati non è collegata, una pagina che dice "presto disponibile".
Non si applica a una superficie vuota perché l'utente non ha ancora fatto nulla. Una lista di task senza task è corretta, e dovrebbe indicare come aggiungerne uno.
Fai
- Decidi di che tipo di vuoto si tratta. Vuoto-perché-l'utente-è-nuovo ha bisogno di un buon empty state con dentro l'azione successiva. Vuoto-perché-non-l'abbiamo-ancora-costruito ha bisogno di non esistere.
- Per il secondo tipo: non renderizzare affatto la destinazione. Genera la route solo quando c'è qualcosa dietro.
- Se deve esistere per lo sviluppo, proteggila con un flag di sviluppo così una build installata non può raggiungerla.
- Dove il vuoto è genuinamente la notizia — un hub con una sola voce, un feed appena iniziato — dillo a parole, e rendi l'invito a contribuire il contenuto principale della pagina.
Evita
"Presto disponibile", "Nessun dato ancora" senza spiegazione, e una voce di navigazione che porta a una colonna vuota. Ognuna costa al lettore un click e non restituisce nulla, e dopo due di queste smette di fidarsi della navigazione — un costo pagato da ogni altra pagina del prodotto.
Evita anche la versione che sembra a posto: una pagina di categoria che si renderizza correttamente con zero elementi. Non sembra rotta, quindi nessuno la segnala, e silenziosamente comunica che il progetto ha abbandonato quell'argomento.
Verifica
Carica la superficie con una fonte dati vuota e leggi cosa vedrebbe un utente alla prima visita. Se la risposta è un titolo e spazio bianco, non avrebbe dovuto essere rilasciata.
Per le route generate il controllo è meccanico: verifica che la lista delle route sia derivata dal contenuto, così una categoria senza voci non produce alcuna pagina.
Rischio
Nascondere una destinazione finché non ha contenuto fa spostare la navigazione man mano che arrivano i dati, il che può disorientare — un menu che cresce tra una visita e l'altra ha bisogno di un motivo che l'utente possa intuire.
Questo può anche essere spinto troppo oltre, fino a nascondere funzionalità semplicemente poco usate. Il confine è se la superficie potrà mai mostrare qualcosa: il non-costruito va nascosto, il non-usato va mostrato con un buon empty state.
Come usarla
La scheda è un dato. Clona il repository e importala per percorso — ciò che arriva dalla rete è trattato come contaminato e trattenuto in attesa di approvazione, che è il comportamento desiderabile e il motivo per cui qui non c'è un installatore in una riga.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/do-not-ship-an-empty-surface/SKILL.mdIntegrità
SHA-256 del file così com'è pubblicato. Chi lo importa può verificare che ciò che ha ricevuto sia ciò che questa pagina mostrava.
c4dbc6291edf3d41c3820bea6ed19cd283dd90e75d41d61dad97bdab972b7965