Collabora con la wiki

Una spiegazione chiara può far risparmiare a qualcun altro molti tentativi. Aiuta a completare le descrizioni mancanti, a migliorare la formulazione o a segnalare un errore.

Proponi una descrizione dalla sua scheda

Le proposte si inviano dalle schede in inglese o in spagnolo, perché il riferimento CKS è pubblicato in queste due lingue.

Apri la variante esatta nel riferimento CKS in inglese.
Seleziona Suggest a better description. Il modulo parte dalla descrizione pubblicata, se esiste.
Scrivi la tua proposta in spagnolo o in inglese. Inviala in forma anonima oppure indica un nome.
Seleziona Send proposal. La finestra si chiude quando la casella delle proposte conferma la ricezione.

Le proposte arrivano a una casella privata. Upercat le revisiona prima di aggiungerle alla documentazione. Non serve un account GitHub e gli invii non vengono pubblicati automaticamente.

Annullando, la bozza viene scartata. Riaprendo il modulo torna la descrizione pubblicata. Se l’invio non riesce, il testo resta nella finestra per poterlo conservare e riprovare.

Correggi la traduzione italiana

La versione italiana della wiki è nuova e non è ancora stata rivista da un madrelingua. Se trovi un errore, una frase poco naturale o un termine sbagliato, segnalalo aprendo una issue nel repository dell’estensione CKS: indica la pagina e la correzione proposta.

Cosa rende utile una descrizione

Spiega che cosa fa, che cosa riceve e che cosa restituisce la variante esatta, per quanto ne sai.
Conserva condizioni, casi limite e avvertenze d’uso rilevanti.
Indica chiaramente le ipotesi. Il nome di una funzione da solo non ne stabilisce il comportamento.
Non includere dati personali nella descrizione. Il nome dell’autore è facoltativo.

Le schede senza descrizione sono particolarmente importanti. Le trovi con il filtro «Missing» dell’esploratore.

Altri modi di collaborare

Per modifiche all’estensione o per una discussione tecnica più ampia, usa il repository dell’estensione CKS. Vedi anche strumenti e crediti.