Fedora Online Forum

Lavori in corso! I nostri pinguini sono all'opera e risolveranno i problemi il prima possibile ;-)

#1 10-10-2017 10:31:06

bebo_sudo
Collaboratore
Da Trento+Trieste
Registrato: 28-02-2011
Messaggi: 1'665
Sito web

Sondaggio sull'utilizzo della documentazione di FOL

Buongiorno!
Come staff stiamo valutando alcuni cambiamenti alla nostra doc.
Per questo abbiamo scritto questo sondaggio: https://goo.gl/forms/YsKwWdoV1RKA5Geo1
a cui tutti gli utenti di FOL (e non) sono invitati a partecipare.

Edit: aggiornato il questionario aggiungendo alcune risposte positive in merito all'utilita' della doc (domanda 4), grazie al commento di robyduck e alle prime risposte ricevute.

Ultima modifica di bebo_sudo (10-10-2017 17:02:19)


Documentation Admin                ~~~~~                La pigrizia sterminerà l'umanità.

Non in linea

#2 10-10-2017 12:06:36

arkanoid
Moderatore
Da Trento
Registrato: 06-05-2010
Messaggi: 2'142
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Oltre all'ottima idea del sondaggio, vorrei precisare che questo è il luogo (e il momento) adatto per raccogliere tutte le opinioni e i consigli della community, in merito all'argomento in oggetto smile.

Per cui... Per qualsiasi questione (sia pro che contro, tecnica o meno), siamo aperti al dialogo e al confronto.


|| FAS: juliuxpigface || IRC: jpigface || GITHUB: pigjuliux ||

Non in linea

#3 10-10-2017 14:23:11

robyduck
Fedora Ambassador
Registrato: 08-12-2004
Messaggi: 8'023
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Dico anche la mia chiedendo quale sia l'obiettivo di questo sondaggio. La chiusura della documentazione?
Mi sembra di capire di sì, visto che la domanda sull'utilità contiene solo risposte negative.
Personalmente credo che sia legittimo porsi questa domanda se non ci sono redattori sufficienti per continuarla. Lo storico però lo terrei, ovvero le guide esistenti. Io stesso per alcune configurazioni che non ricordo a memoria la uso, e trovo il più grande vantaggio nell'avere molte guide e configurazioni in un unico posto. Toglierla sarebbe una perdita e non dimentichiamo che Google stesso rimanda spesso a FOL per ricerche in italiano.

Non in linea

#4 10-10-2017 15:25:59

bebo_sudo
Collaboratore
Da Trento+Trieste
Registrato: 28-02-2011
Messaggi: 1'665
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ho aggiornato il sondaggio aggiungendo possibili risposte positive alla domanda in merito all'utilita' di doc.fol, grazie al commento di roby.


Documentation Admin                ~~~~~                La pigrizia sterminerà l'umanità.

Non in linea

#5 10-10-2017 16:42:55

marcomotta
Moderatore
Da Roma
Registrato: 18-01-2009
Messaggi: 2'779
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Se posso fare un'altra obiezione al sondaggio, le risposte che si possono dare alla domanda "Se hai usato la documentazione di FOL, come l'hai trovata?" sono (parafrasando un po'):
"Ottima", "fa schifo", "fa vomitare", "non ci capisco nulla", e così via. Una risposta positiva senza esitazione, e tutte le altre che esprimono solo critiche. Forse sarebbe stato meglio "Dai un voto da 1 a 10 alla documentazione", e poi "Quanto trovi aggiornata la documentazione? Dai un voto da 1 a 10", e così via.
Così mancano tutte le valutazioni intermedie.


La filosofia è una disciplina con obiettivi, ma senza regole. La matematica è una disciplina con regole, ma senza obiettivi.
Un giorno ho incontrato un uomo che non aveva né obiettivi né regole. Studiava filosofia della matematica.

Non in linea

#6 10-10-2017 16:49:43

lablinux
Pinguino avanzato
Da Rho, Milano
Registrato: 08-04-2009
Messaggi: 310

Re: Sondaggio sull'utilizzo della documentazione di FOL

io ho messo Altro: Funzionale [non ricordo l'esatto aggettivo ma era posivito e ho trovato sbagliato che fossero solo "selezioni" negative]
Chi ha già votato? Si riparte da zero? Lo chiedo perché non conosco il sistema di sondagi di google

Ultima modifica di lablinux (10-10-2017 16:51:04)


Linux counter home page #501787
Linux machine #5389505

Non in linea

#7 10-10-2017 17:02:07

bebo_sudo
Collaboratore
Da Trento+Trieste
Registrato: 28-02-2011
Messaggi: 1'665
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ok, giustamente ho aggiunto un paio di possibilita' alla domanda sulla qualita' ed aggiunto due domande aperte sugli argomenti che vengono piu' cercati e sugli argomenti che si vorrebbero vedere.

Se volete partecipare di nuovo fate pure! Semplicemente le domande che prima non c'erano ora sono viste come vuote.


Documentation Admin                ~~~~~                La pigrizia sterminerà l'umanità.

Non in linea

#8 10-10-2017 17:37:38

antowen
Collaboratore
Da Ostrava
Registrato: 21-03-2010
Messaggi: 1'251
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Avevo risposto al sondaggio stamane e l'ho rifatto poco fa visto che ci sono state delle modifiche,
Se posso dire la mia, sono daccordo con Roby specialmente riguardo alla parte:

"Toglierla sarebbe una perdita e non dimentichiamo che Google stesso rimanda spesso a FOL per ricerche in italiano."

Anche una documentazione non aggiornata o obsoleta aiuta comunque, a volte la semplice pigrizia dell'utente, vi faccio l'esempio mio, la parte Multimedia e Codecs, non perdo molto tempo a cercare su google se so che su FOL c'e' un doc dove copiando e incollando il comando

# dnf install gstreamer-{ffmpeg,plugins-{good,ugly,bad{,-free,-nonfree}}} gstreamer1-{plugin-mpg123,libav,vaapi,plugins-{base,bad-free{,world,-extras},good{,-extras},ugly}}

li posso installare tutti senza perdere tempo.

Quante volte vi e' capitato di cercare un doc su google e di trovare i post di forum di 4/7 anni prima?
La Documentazione di FOL e' una risorsa importante.


Antonio G. Fedora 28 Mate
antowen.com

Non in linea

#9 10-10-2017 20:39:17

bebo_sudo
Collaboratore
Da Trento+Trieste
Registrato: 28-02-2011
Messaggi: 1'665
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ragazzi calma, non stiamo dicendo che faremmo un flush su /dev/null.
La doc ci sara', stiamo pensando anche di migliorare il supporto tecnico su cui e' appoggiata.

Questo sondaggio serve per capire gli interessi della community.


Documentation Admin                ~~~~~                La pigrizia sterminerà l'umanità.

Non in linea

#10 11-10-2017 06:51:54

Moreno
Fedora nel sangue
Registrato: 05-03-2009
Messaggi: 1'326

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ciao

Visto che ci sono già passato ho da darvi un consiglio.
GUAI a cambiare gli URL della documentazione, si creano casini a non finire per anni.
Salterebbero tutte le citazioni che per loro natura usano un URL assoluto.

Se proprio si volesse ripartire da 0 la cosa migliore da fare sarebbe un freeze dell'esistente e ripartire con un sito nuovo di zecca.


Ciao Ciao, Moreno


Io vado ovunque dove ci sia Linux.
Avatar by moonlight-dream.

Non in linea

#11 11-10-2017 10:36:02

Simone89
Pinguino avanzato
Registrato: 16-02-2013
Messaggi: 279

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ho fatto il sondaggio. Non so cosa pensare della documentazione nel senso che fedora è diventata talmente user friendly che una qualsiasi documentazione rende le cose più complicate di quello che effettivamente sono. Per i problemi un attimino più complicati di solito trovo la risposta o nella documentazione ufficiale o su google che mi rimbalza su un qualche ask. Oppure al posto di leggere pagine di informazioni che in quel momento non mi servono (perché lo scopo in quel momento è quello di riavere una macchina funzionante) preferisco chiedere su irc o sul forum. Invece per la documentazione che leggo a scopo didattico di solito cerco doc internazionale.

Quindi se devo dire la mia opinione penso che la documentazione "didattica" abbia il problema che compete con quella internazionale che è per forza di cose più aggiornata e completa. Quindi non so quanto valga la pena investirci tempo e forza lavoro quando le braccia sono quelle che sono e l'impegno (almeno per la mia breve esperienza che ho avuto) è molto discontinuo. Invece per quanto riguarda le guide di supporto possono avere un loro perché, ad esempio come pagine da linkare all'interno del forum. A quel punto una guida potrebbe diventare un thread del forum. Si potrebbe pensare di creare una sezione documentazione dove le problematiche maggiori vengono copiate e esposte (si tratterebbe di prendere thread esistenti e fare dei riassunti). Anche lì, senza troppi fronzoli perché confondono solo l'utente inesperto e se si vuole approfondire uno può sempre fare una ricerca su google.

Non in linea

#12 14-10-2017 16:42:33

Raznum
Pinguino avanzato
Registrato: 06-03-2016
Messaggi: 103

Re: Sondaggio sull'utilizzo della documentazione di FOL

arkanoid ha scritto:

Oltre all'ottima idea del sondaggio, vorrei precisare che questo è il luogo (e il momento) adatto per raccogliere tutte le opinioni e i consigli della community, in merito all'argomento in oggetto smile.

Per cui... Per qualsiasi questione (sia pro che contro, tecnica o meno), siamo aperti al dialogo e al confronto.

Dove/Come lo facciamo? Utilizzando questa discussione o aprendo un argomento per ogni questione (come da regolamento valido per tutte le altre cose)?


Fedora 25.
KDE per tutta la vita!

Non in linea

#13 15-10-2017 09:44:18

arkanoid
Moderatore
Da Trento
Registrato: 06-05-2010
Messaggi: 2'142
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ciao Raznum.

Se vuoi esprimere la tua opinione a riguardo della documentazione di FOL, è possibile utilizzare questa discussione. Al di là del sondaggio infatti, sarebbe utile raccogliere qui i pareri attuali della community in merito alla nostra documentazione. Non credo ci sia il rischio di "andare off-topic" in quanto stiamo proprio valutando una completa ristrutturazione della stessa e, pertanto, qualsiasi opinione è la benvenuta.

Se invece hai richieste riguardanti sito e/o forum, puoi aprire un nuovo topic in "Suggerimenti e critiche".


|| FAS: juliuxpigface || IRC: jpigface || GITHUB: pigjuliux ||

Non in linea

#14 21-10-2017 16:31:52

Raznum
Pinguino avanzato
Registrato: 06-03-2016
Messaggi: 103

Re: Sondaggio sull'utilizzo della documentazione di FOL

Grazie arkanoid.

Forse bisognerebbe chiedersi quale tipo di utente si vuole conquistare (e/o formare) prima di decidere che fare con la documentazione.
È da tanto che non do uno sguardo alla documentazione, quasi due anni, ossia all'inizio che mi sono interessato a Fedora, però ricordo che interpretai la documentazione e la distribuzione come qualcosa per utenti avanzati. Il che mi spaventò un po', però poi decisi di procedere ugualmente.
Questo può essere un limite per chi è principiante di linux, principiante sia in senso temporale sia in senso di competenze. Io, ad es, uso linux da tanti anni ma ho avuto, da un lato, poca pretesa nei confronti del S.O. e, dall'altro, la fortuna di non aver avuto problemi riguardo quelle poche cose che facevo col pc, infatti faccio tutto per via grafica, il terminale lo uso solo per installare e rimuovere programmi.
...scusa se ho parlato di me...ritornando alla Doc, mi pare manchino concetti di base sul terminale come: sintassi e simbologia dei comandi; come interpretare la pagina man e i risultati di un comando; etc...
Se poi non c'è la possibilità di realizzare guide del genere e magari sono presenti già in qualche altro sito, penso, si potrebbe pubblicare i link relativi (se non violano la linea editoriale del portale FOL). In questo modo FOL indicherebbe all'utente un percorso più completo.

Un'altra cosa. Ricordo che in vari frangenti l'impaginazione caratteristica del wiki è scomoda, sopratutto quando ci sono i comandi e risultati.
Che voi sappiate, esistono altri software a scopo didattico alternativi al wiki?


Fedora 25.
KDE per tutta la vita!

Non in linea

#15 11-11-2017 21:00:04

bebo_sudo
Collaboratore
Da Trento+Trieste
Registrato: 28-02-2011
Messaggi: 1'665
Sito web

Re: Sondaggio sull'utilizzo della documentazione di FOL

Ecco i risultati del sondaggio (tenete conto che ci sono dei duplicati): https://docs.google.com/spreadsheets/d/ … sp=sharing


Cerco di riassumerli (per fare in modo che resti qualcosa sul forum in caso non ci fosse piu' il link):

  • Tutti gli utenti intervistati conoscono doc.fol, ma poco meno del 90% l'ha usato.

  • quando gli utenti hanno un problema cercano su google o sul forum di FOL nella stragrande maggioranza dei casi, in misura lievemente minore direttamente su doc.fol: sono usate anche la wiki ufficiale di fedoraproject.org, in inglese e in italiano, stackoverflow ed IRC.

  • Arrivando alla qualita' di doc.fol, la maggior parte degli utenti la trova poco aggiornata, ma anche utile e comprensibile, per alcuni e' semplicemente ottima cosi' com'e', per altri e' poco organizzata, e solo due utenti la trovano di difficile comprensione (sarebbe utile sapere quali argomenti sono piu' ostici, e capire se si puo' renderli piu' comprensibili).

  • La doc risulta essere mediamente aggiornata, con una leggera tendenza verso il "poco aggiornata".

  • Per due terzi, la struttura delle guide va bene cosi' com'e'.

  • Circa l'80% degli utenti non ha problemi a leggere documentazione in inglese.

  • 40% degli intervistati sarebbe interessato a scrivere delle guide/tutorial in doc.fol, altrettanti non lo sono, ed il restante 20% e' indeciso.

  • Interessante la domanda seguente: il 60% afferma che non sarebbe pero' interessato ad entrare nei redattori di fol, mentre il restante 40% (circa la stessa percentuale di quelli che vorrebbero scrivere guide) sarebbe interessato a diventare redattore.

  • Gli argomenti piu' interessanti sembrano essere le prime configurazioni, la guida ai codec e quella di aggiornamento di versione.

  • Incollo direttamente invece gli argomenti che gli utenti vorrebbero vedere nella doc:

    1. guide alla configurazione post-installazione

    2. Argomenti relativi all'utilizzo server

    3. Sicurezza, gpg, programmi di scrittura come markdown o retext

    4. sarebbe bello avere una versione italiana di Fedora Magazine; a volte è un valido sostituto alle mini-guide ed aiuta a far scoprire nuovi programmi

    5. dipende

    6. primi passi post install per principianti. configurare ambienti di lavoro per task particolari (web dev, audio editing, grafica 2d/3d)

---------------------------------------------------------------------------------------------

Ho pensato ultimamente a come si potrebbe ristrutturare la doc, e vorrei continuare la discussione qui con tutti gli utenti di FOL per condividere le idee.

Penso che si potrebbe creare una "TODO list" con le guide sugli argomenti che gli utenti vorrebbero nella doc: chiunque potrebbe contribuire scegliendo un argomento dalla lista (che lo scrittore conosce, di cui si sente invogliato a scrivere, e che viene ritenuto piu' importante tra quelli richiesti dalla comunita'), condividendo cosi' le conoscenze delle proprie aree o dei propri interessi; anche dal sondaggio risulta che gli interessi degli utenti sono variegati, si passa dal livello principiante, all'utente che vuole guide piu' da "sistemista", a quello che vuole scoprire nuovi programmi, etc.

Per la parte tecnica, ci stiamo organizzando come staff per rendere la scrittura di guide un processo meno burocratico, con l'idea che questo possa aiutare a coinvolgere tutti gli utenti di FOL.

In questa mia visione, il ruolo dei redattori diventerebbe di "supporto" e di revisione finale della guida.

Bonus: feedback sulle guide scritte.


raznum ha scritto:

ritornando alla Doc, mi pare manchino concetti di base di .. linux [ndr]
Se poi non c'è la possibilità di realizzare guide del genere e magari sono presenti già in qualche altro sito, penso, si potrebbe pubblicare i link relativi (se non violano la linea editoriale del portale FOL). In questo modo FOL indicherebbe all'utente un percorso più completo.

si', costruire una "raccolta di link" puo' essere una buona idea, perche' non abbiamo le forze per scrivere manuali di utilizzo di bash o altri programmi "generici" di linux.

Vi invito a condividere le vostre impressioni in merito a questo piano d'azione, e vi invito a proporre la vostra idea di come vorreste organizzare la doc per il futuro smile


Documentation Admin                ~~~~~                La pigrizia sterminerà l'umanità.

Non in linea

Piè di pagina