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

MANIFESTO di IT.COMP.LANG.VISUAL-BASIC

Versione: 1.0.8
Prima stesura: 30/10/1998
Ultima revisione: 21/08/2001

In questo documento sono elencate le regole a cui si dovrebbero attenere tutti i
partecipanti del newsgroup.


Questo documento viene postato sul newsgroup ogni settimana 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.it-lang-vb.net/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.
Le modifiche non sostanziali, ovvero:
- modifica di un indirizzo di posta elettronica o di un URL
- modifica di un nome proprio o di cosa
- correzioni di sintassi o forma
potranno esser fatte direttamente dal WebMaster in carica o da persona delegata, senza 
sottostare a votazione.
Il WebMaster o chi per esso notificherà al newsgroup tali modifiche in un post dal soggetto
"[MANIFESTO] Correzioni apportate"

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


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 in italiano (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. Sono da evitare messaggi di test in quanto 
esistono newsgroup appositi, come appunto it.test.


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. 
Lo scambio di files binari può essere effettuato utilizzato il gruppo
it.binari.file, e notificandolo su it.comp.lang.visual-basic con prefisso
[!] (v. Articolo 10).
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
inviarlo al Webmaster tramite il modulo presente sul Sito Comune, che provvedera'
a renderlo disponibile sul sito stesso.
L'indirizzo e-mail del WebMaster è: webmaster@it-lang-vb.net. Tale indirizzo può 
venir utilizzato solo per comunicazioni riguardanti il Sito Comune e per l'invio 
di materiale da pubblicare sul sito stesso; non deve venir utilizzato per richiedere
aiuti o consigli riguardanti la programmazione o per comunicazioni private al WebMaster
di turno.

Articolo 9)
Evitare di scrivere o rispondere a messaggi OT (ossia Off Topic: che non
riguardano gli argomenti trattati in questo newsgroup, vedi articolo 1).
In particolare occorre evitare assolutamente di rispondere a messaggi di 
annunci pubblicitari o messaggi tipo:
- "Super-mega sito porno..."
- "Tizio ha guadagnato 20000 dollari, prova anche tu..."
perche' le risposte non arrivano mai al colpevole (chi lo
ha spedito), e risultano esse stesse 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, acidità... (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 (v. Articolo 10).

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) in un messaggio il 
cui oggetto dovrà contenere il prefisso [!] (v. Articolo 10).
Naturalmente le soluzioni migliori potranno essere inviate al
WebMaster (v. Art. 8) e pubblicate 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 -----------------------------------------------------------