Buon pomeriggiowilecoyote ha scritto: ↑lunedì 18 ottobre 2021, 21:50) Salve, perfetto, fa sapere quando finisci.
:: Ciao
penso di aver terminato la pagina di prova. Se c'è ancora qualcosa da dover inserire,... avvisatemi. Grazie
Moderatore: Gruppo Documentazione
Buon pomeriggiowilecoyote ha scritto: ↑lunedì 18 ottobre 2021, 21:50) Salve, perfetto, fa sapere quando finisci.
:: Ciao
@wilecoyote cosa mi combini?wilecoyote ha scritto: ↑mercoledì 20 ottobre 2021, 15:44) Salve, fatta la 1° revisione, commenti, suggerimenti, insulti… ?
:: Ciao
ivantu ha scritto: ↑mercoledì 20 ottobre 2021, 16:41ecco appunto, non deve essere un'enciclopedia. Mi sembra ovvio, che le tabelle danno proprio questo aspetto enciclopedico.
edit: se avete delle nuove direttive tra GruppoDocumentazione che vi siete regolamentati in privato, fatemelo sapere. Così, non ci allunghiamo con questi discorsi
@xavier77 ci sei?
Regole generali
Per scrivere una buona guida, o della buona documentazione, è utile tenere a mente questi semplici concetti.
Una buona guida deve essere:
Chiara
Esprimere i concetti in modo semplice.
Coerente
Usare una terminologia approvata e standardizzata all'interno di tutte le guide, facendo uso dei glossari approvati.
Concisa
Deve essere orientata all'uso immediato: il wiki non è un'enciclopedia.
Completa
Quanto più possibile. Deve descrivere, se non tutti, almeno gli aspetti più importanti di un programma o prendere in esame le parti più salienti di ciò che si vuole descrivere.
wilecoyote ha scritto: ↑mercoledì 20 ottobre 2021, 16:29E le regole le conosco, infatti come riportato in GuidaWiki/RegoleStilistiche, cerco sempre d'essere conciso, anche se mi capita di tracimare coi dettagli.
Capisco e mi dispiace molto.xavier77 ha scritto: ↑giovedì 21 ottobre 2021, 15:46Come avrete dedotto, al momento tanti del gruppo doc non stanno molto sul pezzo. Chi per impegni lavorativi (come il sottoscritto) chi per altro.
Ce la fate a scrivere un elenco delle cose su cui non riuscite a trovare una visione comune, possibilmente sintetico ed evitando troppi botta-e-risposta? Grazie!
All’interno della tabella puoi lasciare i comandi per intero (tipo sudo systemctl start bluetooth....). Così un utente poco esperto evita di confondersi. Va bene ugualeivantu ha scritto: ↑giovedì 21 ottobre 2021, 18:02@jeremie2, mentre tu scrivevi il post, io ho rimesso mani alla wiki di prova rimettendoci le tabelle come da prima revisione.
Poi riguardando le altre sottopagine wiki per esempio AuricolariBluetooth, ci sarà poi anche quella da riscrivere, penso che in questo senso specifico se si andrebbe a sintetizzare con le tabelle, l'utente si dovrebbe leggersi tutta la pappardella del parametro per parametro, alla ricerca di quello specifico e non è veloce alla lettura, l'utente si stuferebbe, e non tenterebbe di finire a risolvere il problema di connessione.
jeremie2 ha scritto: ↑giovedì 21 ottobre 2021, 17:39Detto questo, direi che la revisione di wilecoyote, almeno sotto l'aspetto dell'organizzazione delle informazioni vada bene. Quindi suggerisco di continuare da quella revisione. La cosa più importante da tenere d'occhio come al solito è la correttezza dei dati.
jeremie2 ha scritto: ↑giovedì 21 ottobre 2021, 17:39Tanto ormai mi sono dilungato..
Mi spiace di non poter essere presente come in passato. Il motivo per il quale continuo a rivestire questo ruolo è per cercare di dare un minimo di continuità alle funzioni base del wiki inteso anche come piattaforma.
Purtroppo siamo in pochi e con poco tempo a disposizione. Quindi personalmente cerco di attivarmi perlomeno in presenza di problemi gravi/fondamentali (bug installer per sistemi bios, estensione gnome che manda in crash il sistema, aggiornare macro wiki in seguito a cambio politiche sulle EOL, leggibilità wiki su smartphone..) o comunque attività basilari come tenere aggiornate le pagine ai vari rilasci di Ubuntu e intervenire in caso di problemi di moderazione.
Lo so, non è il massimo, e mi scuso.
Ma colgo l'occasione per ringraziare chi continua a interessarsi al wiki, come @wilecoyote (senza di lui la sezione forum del gruppo doc sarebbe naufragata). Ma anche a utenti come @ivantu che grazie alla loro passione e competenza mantengono vive le guide del wiki
A quanto pare
Si, ma scritto così sembra un pacchetto necessario.wilecoyote ha scritto: ↑sabato 23 ottobre 2021, 0:33Un po' perché migliora le prestazioni energetiche in generale del computer, ed un po' perché finalmente ho trovato un'installazione, (MX-Live 20), senza il pacchetto già installato.
jeremie2 ha scritto: ↑sabato 23 ottobre 2021, 13:02Si, ma scritto così sembra un pacchetto necessario.wilecoyote ha scritto: ↑sabato 23 ottobre 2021, 0:33Un po' perché migliora le prestazioni energetiche in generale del computer, ed un po' perché finalmente ho trovato un'installazione, (MX-Live 20), senza il pacchetto già installato.
Se serve solo per il risparmio energetico, allora è fuori posto. Se invece tramite esso è possibile accedere a settaggi per il bluetooth allora è il caso di specificarlo, magari segnalandolo come pacchetto suggerito... ed eventuale paragrafo per il suo utilizzo (o sottopagina se particolarmente lungo).
Visualizzano questa sezione: 0 utenti iscritti e 9 ospiti