Newsgroup: it.comp.lang.visual-basic
Titolo: [MANIFESTO] Manifesto ufficiale di it.comp.lang.visual-basic

----------------------------------------------------------------------------
MANIFESTO di IT.COMP.LANG.VISUAL-BASIC
Versione: 1.0.4
Prima stesura: 30/10/1998
Ultima revisione: 14/05/1999
In questo documento sono elencate le regole a cui si devono attenere tutti i
partecipanti del newsgroup.
Questo documento viene postato sul newsgroup ogni 2 settimane e con un
subject ben chiaro: "[MANIFESTO] Manifesto ufficiale di
it.comp.lang.visual-basic".
La copia aggiornata di questo documento e' reperibile sul Sito Comune del
newsgroup, all'indirizzo:
http://www.murialdo.it/it_lang_vb/docs/Manifesto.txt
 (nella sezione
Documentazione del Sito Comune).
NOTE:
Le eventuali modifiche al Manifesto verranno apportate solo per comune
accordo dei partecipanti del NG.
Le richieste di modifica possono pervenire da qualsiasi partecipante al
newsgroup, e devono essere segnalate sul newsgroup stesso tramite messaggio
di proposta con subject: "[MANIFESTO] Modifiche" o simile. Le proposte di
modifica verranno sottoposte a votazione, alla quale potranno partecipare
tutti i frequentatori del newsgroup.
----------------------------------------------------------------------------
REGOLE GENERALI
------------------------------
Articolo 1)
Questo gruppo e' dedicato alle discussioni di carattere tecnico o di
interesse generale riguardanti l'ambiente di sviluppo Microsoft Visual Basic
e di tutti gli strumenti aggiuntivi di terze parti disponibili (VBX, OCX,
DLL ecc.).
1bis) [VBA e VBScript]
In mancanza di altri newsgroup specifici (come it.comp.database.access), e
finche' non verranno creati newsgroup per VBScript, tali argomenti saranno
ospitati su questo newsgroup. Anche (e soprattutto) per questi argomenti e'
buona norma mettere nel subject dei messaggi una sigla in maniera esplicita:
[VBA] o  [VBSCRIPT].
Si noti che il VBA relativo ad Access dovrebbe essere comunque discusso su
it.comp.database.access.
Articolo 2)
Il gruppo, che si occupa delle versioni attuali e future del pacchetto
Microsoft, puo' essere usato anche per scambiare indirizzi interessanti
(www, ftp, gopher o altro), riguardanti l'argomento trattato (Visual Basic).
Articolo 3)
Chi non rispetta le elementari regole di convivenza sul newsgroup dovrebbe
essere educatamente invitato a leggerle su questo Manifesto e a rispettarle.
L'invito dovrebbe essere spedito via e-mail privata: in questo modo si
raggiunge direttamente l'interessato e si evita di intasare inutilmente il
newsgroup.
Articolo 4)
I partecipanti alle discussioni su questo newsgroup sono tenuti a
rispettare, per  quanto possibile, le idee altrui e mantenere un
comportamento il piu' possibile educato e corretto.
Articolo 5)
In caso di inesperienza nell'utilizzo dei newsgroups, potrebbe essere una
buona pratica, per capire le regole che lo governano, la vecchia regola di
frequentare "in ombra" (cioe' solo leggendo i messaggi) il newsgroup prima
di postare.
Articolo 6)
In caso di difficolta' nella trasmissione di messaggi al newsgroup, i
messaggi di prova devono essere postati sul newsgroup it.test, che e' stato
costituito proprio per questo scopo. In nessun caso saranno tollerati
messaggi di test su questo newsgroup.
REGOLE PER I MESSAGGI
----------------------------------------
Articolo 7)
I messaggi devono sempre essere in plain ASCII (solo testo), non sono
ammessi messaggi in HTML, ne' codificati in alcun modo (Base64, Rot13 e via
dicendo).
La stessa regola vale per eventuali sorgenti e pezzi di codice, i quali
dovranno essere inseriti in formato testo (plain ASCII) nel corpo del
messaggio e non in attachment.
Articolo 8)
In questo newsgroup non sono ammessi in alcun caso files binari in
attachment, un apposito robot si occupa dell'eliminazione degli stessi. Per
lo scambio di files binari deve essere utilizzato il gruppo
it.binari.visual-basic.
I files binari (DLL, OCX, etc.) possono essere inviati, a chi ne faccia
esplicita richiesta, via e-mail privata.
In caso di materiale interessante per il NG, e freeware, e' consigliato
spedirlo al webmaster del sito comune, che provvedera' a renderlo
disponibile sul sito stesso.
Articolo 9)
Evitare di scrivere o rispondere a messaggi OT (ossia Off Topic: che non
riguardano gli argomenti trattati in questo newsgroup).
Inoltre evitare di rispondere a messaggi di annunci pubblicitari o simili.
Esempio:
- "Super-mega sito porno..."
- "Tizio ha guadagnato 20000 dollari, prova anche tu..." In genere le
risposte a tali messaggi non arrivano mai al colpevole (chi lo ha spedito),
inoltre risultano piu' dannose al newsgroup, poiche' amplificano il disturbo
dato dal messaggio originale.
Articolo 10)
Nel soggetto del messaggio dovrebbe essere specificata la tipologia del
messaggio stesso, tramite l'uso di una notazione semplice ed intuitiva, ad
esempio:
[MANIFESTO] : Il manifesto del gruppo o discussioni su di esso;
[FAQ] : la FAQ del gruppo o discussioni su di essa;
[SITO COMUNE] : annunci o discussioni riguardanti il Sito Comune; [?] :
domande;
[?2] : domande gia' postate, che non hanno ricevuto una risposta valida; [!]
: comunicazioni importanti, la risoluzione di un bug...;
[VBA] : Visual Basic for Application
[VBSCRIPT] : Visual Basic Script
[CERCO] : ricerco una DLL, un OCX, o del materiale relativo a VB; [OT] :
battute, motti di spirito, acidita' nei confronti di Bill... (Da usare con
moderazione!)
Dopo questa notazione dovra' essere indicato sinteticamente il
problema/soluzione/considerazione.
-Ho un problema con l'oggetto printer: voglio cambiare il formato della
carta:
[?] Printer: come cambiare il formato carta?
-Non riesco ad usare l'API GetPaperinoChunk()
[?] API GetPaperinoChunk(): come si usa?
DA EVITARE ASSOLUTAMENTE i soggetti generici e non chiari, tipo:
"aiutatemi...", "per gli esperti...", "risolvete questo...", ecc...
Articolo 11)
Evitare di apporre alla fine del messaggio firme eccessivamente lunghe. Chi
vuole dare piu' informazioni, basta che indichi l'indirizzo della propria
pagina web.
REGOLE PER I MESSAGGI (DOMANDE)
----------------------------------------
Articolo 12)
Prima di postare una domanda, assicurarsi che l'argomento non sia trattato
nelle fonti di informazione incluse in Visual Basic (help in linea e
manuali) e non sia gia' stato trattato in precedenza sul newsgroup. Per
controllare i messaggi vecchi del newsgroup e' possibile utilizzare i motori
di ricerca per newsgroups (Es. 
www.deja.com
).
Articolo 13)
All'inizio del messaggio dovra' essere chiaramente indicato sia la versione
dell'ambiente di sviluppo usato (includendo gli aggiornamenti eventuali),
che il sistema operativo (patch incluse, anche qui); queste informazioni
saranno utili agli altri per dare una risposta il piu' possibile corretta.
Dopo di ciò si dovrà indicare il problema, riportando eventualmente anche la
routine (opportunamente sintetizzata) che non funziona. Eventuali richieste
di aiuto devono essere precise, in grado di focalizzare il problema, e se
necessario (spesso), esponendo in che contesto e' applicato il problema
stesso.
Evitare testi del tipo: "Ma perche' le date non funzionano nei comandi SQL?"
Bensi': "Ho provato a fare una selezione dei record discriminando per la
data di nascita, tipo "SELECT * FROM tabella WHERE dtNascita=30/10/98", ma
mi da errore di sintassi, dove sbaglio?"
Articolo 14)
Se una domanda inviata al newsgroup rimane senza risposta, il proponente
potrà riproporre il messaggio una seconda volta solo dopo un ragionevole
intervallo di tempo (almeno 4 o 5 giorni). La seconda proposta dovrà
contenere il medesimo messaggio, se possibile riformulato in maniera piu'
chiara, e l'oggetto dovrà contenere il prefisso [?2] che ne descrive la
natura.
Articolo 15)
In caso di problemi nuovi, complessi e particolarmente interessanti, il
richiedente dovrebbe provare le varie soluzioni proposte sia sul newsgroup
che in forma privata per e-mail, o trovate in modo autonomo, ed infine
segnalare sul newsgroup la soluzione corretta (o un riassunto delle
soluzioni alternative, nel caso ne esista piu' di una).
Naturalmente le soluzioni migliori potrebbero essere incluse nella FAQ
(quando sara' pronta), o comunque sul sito comune.
REGOLE PER I MESSAGGI (RISPOSTE)
----------------------------------------
Articolo 16)
Cercare di rispondere il piu' possibile sul newsgroup, in modo che tutti
possano trarne vantaggio, senza naturalmente ingolfare il newsgroup con
messaggi troppo voluminosi.
Articolo 17)
Quotare sempre il messaggio originario, ovviamente cercando di sintetizzarlo
al massimo (e' inutile riportare firma, convenevoli, ecc.): in questo modo
deve essere possibile capire l'argomento della domanda, anche non avendo
seguito tutto il thread di discussione.
Articolo 18)
Per le richieste riguardanti informazioni o materiale che fosse gia'
presente nelle FAQ o sul Sito Comune, e' sufficiente rispondere indicando il
relativo riferimento (indirizzo del Sito Comune).
Articolo 19)
Le risposte dovranno essere attinenti alla domanda ed utili per il
raggiungimento della soluzione. Nel caso la domanda non sia chiara o non ne
vengano specificati dettagli utili a dare la risposta, si dovrebbe invitare
il richiedente a riformulare la domanda in termini piu' precisi. Nelle
risposte inerenti la programmazione sono graditi piccoli esempi (anche in
forma di codice sorgente) che aiutino a capire in modo piu' concreto la
soluzione.
----- FINE -----------------------------------------------------------



 natura.
Per questa propongo un articolo sullo stile di un annuncio che ho letto su
una porta dell'Ufficio del Protocollo del Comune di Modena:
"Qui c'era un cartello con scritto 'Chiudere la porta, grazie!', ma è stato
tolto poichè nessuno lo faceva..."  (incredibilmente ora la porta è sempre
chiusa ^_^)
Zeross







Mazza, mai pensato di sintetizzare?





