Autore Topic: Leggiamo la documentazione !  (Letto 4689 volte)

Offline md9327

  • Moderatore
  • Senatore Gambero
  • *****
  • Post: 2.840
    • Mostra profilo
Re: Leggiamo la documentazione !
« Risposta #15 il: 20 Marzo 2008, 20:29:33 »
Ops, mi era sfuggito il nome della persona, ad ogni modo fà lo stesso...

Per i punti che hai giustamente elencato, sono d'accordo su tutto, a parte che  si tratti di un piccolo esempio o una piccola applicazione, diversamente potrebbe essere un problema documentare il tutto se il codice viene scritto da un singolo individuo. Ma questo riguarderà senz'altro codici di esempio e/o piccole librerie, per cui non vedo problemi.

Penso che, a livello di funzionalità generiche, che possiamo mettere in condivisione, le tue specifiche siano norme di consuetudine abbastanza comuni e accettate in genere, e io mi trovo pienamente d'accordo. Ad ogni modo, siamo tutti qui per discutere eventuali problemi.

Anzi, potremmo pure pensare che uno di voi webmaster, possa in qualche modo gestire la cosa, evidenziando eventuali problemi, in modo che si possa standardizzare il tutto... ma questo potrebbe anche essere un onere un pò pesante... non sò...

Scusate il mio discorso un pò fumoso, ma sono arrivato or ora, dopo un traffico della m... :-)

Offline Pixel

  • Amministratore
  • Maestro Gambero
  • *****
  • Post: 414
    • Mostra profilo
    • http://www.gambas-it.org
Re: Leggiamo la documentazione !
« Risposta #16 il: 20 Marzo 2008, 22:11:09 »
Perfetto, credo che la cosa migliore sia sfruttare il wiki che permette una stesura ed una revisione veloce ed immediata delle informazioni, permettendo così eventuali correzioni che dovessero insorgere a causa di aggiornamenti di Gambas.
In pratica la mia idea è quella di creare una sezione nella home del wiki di questo tipo:

Codice
---Stringhe
---Internet
---Grafica
---Database
ecc..ecc...
poi per ogni sotto gruppo una lista semplice con un titolo breve ed il redirect alla pagina vera e propria.
Lasciando invece la sezione all'interno del sito per l'invio di software "complesso".
Pensate possa funzionare?
Consigli?
Ciao
Ubuntu Italian Member Ubuntu User 4683
Il mio Blog

Offline md9327

  • Moderatore
  • Senatore Gambero
  • *****
  • Post: 2.840
    • Mostra profilo
Re: Leggiamo la documentazione !
« Risposta #17 il: 20 Marzo 2008, 22:46:53 »
Potrebbe andare...

Ci penso sù, e semmai ti faccio sapere...

Ottimo!!!!

Offline Mario

  • Grande Gambero
  • ***
  • Post: 138
    • Mostra profilo
    • http://overhill1963.blogspot.com/
Re: Leggiamo la documentazione !
« Risposta #18 il: 29 Maggio 2008, 15:30:01 »
Un piccolo dubbio: ho scaricato il PDF dell'ottimo "Gambas Beginners Guide", che mi sembra molto ben fatto, ma anche molto in inglese.
Se decidessi di riscriverlo traducendolo in Italiano, ci sarebbero problemi a metterlo in rete?
Non sono un grande esperto di copyright (ho già problemi a scrivere la parola), ma se non ho capito male la "logica" del tipo di licenza dovrei poterlo fare, no?

Tra l'altro approvo pienamente l'idea del wiki: comodissimo e veloce, anche se richiede il collegamento a internet (salvo la possibilità di scaricarlo completamente per consultarlo in locale, cosa che richiederebbe il server del wiki installato sul proprio PC) :)
Saluti a tutti

Mario

Offline leo72

  • Amministratore
  • Senatore Gambero
  • *****
  • Post: 2.163
    • Mostra profilo
    • http://www.leonardomiliani.com
Re: Leggiamo la documentazione !
« Risposta #19 il: 29 Maggio 2008, 16:01:09 »
Ho letto la licenza OpenContent che accompagna il documento in oggetto e premesso che:
1)
l'autore ne dà utilizzo libero e perpetuo alla comunità Gambas;
2)
la licenza OC permette tutte le modifiche che si vuole al documento originale con l'unica richiesta di:
2.a)
specificare che il documento è stato modificato e le modifiche apportate;
2.b)
allegare una copia della licenza OC al documento;

penso che non ci siano problemi alla pubblicazione della versione tradotta di quel manuale.

Mi sento però in obbligo di precisare che, essendo la guida basata su Gambas 1.0, è ormai datata e relativa ad una versione non più supportata ufficialmente dagli sviluppatori.
Quindi la traduzione dovrebbe prevedere anche una profonda revisione dello stesso documento, dato che i componenti dell'IDE sono stati nel tempo aggiornati, eliminati o introdotti ex-novo.

Morale della favola: può essere un lavoro che potrebbe rendere, alla fine, ma forse il gioco non vale la candela.
Visita il mio sito personale: http://www.leonardomiliani.com

Offline Mario

  • Grande Gambero
  • ***
  • Post: 138
    • Mostra profilo
    • http://overhill1963.blogspot.com/
Re: Leggiamo la documentazione !
« Risposta #20 il: 29 Maggio 2008, 17:07:54 »
Sì, sto notando che ci sono numerose differenze tra quello che dice nel manuale e la versione che sto usando (2.6).
A questo punto si rischia di fare un lavoro per niente o quasi...
Forse la cosa migliore è proprio quella del wiki, magari organizzandolo un poco: gli ho dato uno sguardo e per ora c'è veramente poca roba (non è una critica, ovviamente: tutti lavoriamo per vivere, penso, e il tempo è quello che è...)
Non ne sono sicuro (non sono un esperto di html) ma immagino che da una serie di pagine wiki si possa generare semi-automaticamente un "libro", quindi avremmo due risultati :)
Saluti a tutti

Mario

Offline Pixel

  • Amministratore
  • Maestro Gambero
  • *****
  • Post: 414
    • Mostra profilo
    • http://www.gambas-it.org
Re: Leggiamo la documentazione !
« Risposta #21 il: 29 Maggio 2008, 19:02:28 »
Citazione

overhill ha scritto:
Non ne sono sicuro (non sono un esperto di html) ma immagino che da una serie di pagine wiki si possa generare semi-automaticamente un "libro", quindi avremmo due risultati :)

Ancora più semplice, basta selezionare nel menu del Wiki a sinistra "versione stampabile" ed ecco le pagine per il nostro libro.
Ciao
Ubuntu Italian Member Ubuntu User 4683
Il mio Blog