redazione documentazione:è wikipedia lo strumento giusto?

classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

redazione documentazione:è wikipedia lo strumento giusto?

Italian Wikipedia mailing list
Salve,
come da oggetto, dovrei redigere la documentazione di uno specifico
progetto software. Questo progetto viene redatto da più persone. dovrei
redigere la documentazione. Ho pensato ad un wiki, poichè, ciascun
sviluppatore può scrivere cio di cui è responsabile.
Può essere esportato il contenuto in più formati (pdf, html principalmente).
Sono arrivato a wikipedia, dopo aver fatto anche altre analisi.
La mia domanda è:
è questo lo strumento adatto? O ne esistono di altri, magari più mirati?

Grazie

Renato
_______________________________________________
WikiIT-l mailing list
[hidden email]
Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: redazione documentazione:è wikipedia lo strumento giusto?

Italian Wikipedia mailing list
Salve Renato,

credo che tu stia confondendo due termini, entrambi di solito abbreviati in
"wiki".
Infatti, da un lato, è vero che un wiki è uno strumento adatto alla
scrittura collaborativa di ipertesti, ma quando diciamo questo intendiamo
il software "*mediawiki*", non il progetto "*wikipedia*" che ne è la più
famosa applicazione.
Pertanto, mentre un (media)wiki può davvero essere lo strumento adatto a
quello che intendi fare, non lo è invece wikipedia (che è un'enciclopedia,
i cui contenuti sono basati sul concetto di rilevanza enciclopedica,
qualcosa di traducibile con "Interesse collettivo").

Operativamente, se gestite un vostro server http, dovreste essere in grado
di installare e configurare una vostra istanza del software mediawiki (che
è open source) [1]. Se usate un server commerciale, credo che molti
permettano l'installazione di mediawiki con una procedura automatica.

Non mi dilungo oltre e ti invito a non indirizzare il resto di questa
discussione a questa mailing list che, invece, è proprio dedicata a
wikipedia. (E nemmeno a me che, in realtà, non ho mai installato un
mediawiki *in house *:))

Saluti

Nicola // quatar

[1] https://www.mediawiki.org/wiki/MediaWiki

2016-08-31 9:08 GMT+01:00 Renato Pontefice via WikiIT-l <
[hidden email]>:

> Salve,
> come da oggetto, dovrei redigere la documentazione di uno specifico
> progetto software. Questo progetto viene redatto da più persone. dovrei
> redigere la documentazione. Ho pensato ad un wiki, poichè, ciascun
> sviluppatore può scrivere cio di cui è responsabile.
> Può essere esportato il contenuto in più formati (pdf, html
> principalmente).
> Sono arrivato a wikipedia, dopo aver fatto anche altre analisi.
> La mia domanda è:
> è questo lo strumento adatto? O ne esistono di altri, magari più mirati?
>
> Grazie
>
> Renato
> _______________________________________________
> WikiIT-l mailing list
> [hidden email]
> Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/
> mailman/listinfo/wikiit-l
>
_______________________________________________
WikiIT-l mailing list
[hidden email]
Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: redazione documentazione:è wikipedia lo strumento giusto?

Italian Wikipedia mailing list
Salve,
configurare un wiki con mediawiki all'inizio può sembrare difficile, ma se
usi un hosting con CPANEL troverai già mediawiki pronto da installare.
Secondo me è una delle soluzioni ottimali per poter redigere una guida
software.
Informazioni sul sito di mediawiki mediawiki.org e, se cerchi su google,
troverai utili informazioni.
Se hai bisogno di aiuto io sono qui.
Un saluto,
Ferdinando // Ferdi2005

Il Mer 31 Ago 2016, 10:30 nicola dmt via WikiIT-l <
[hidden email]> ha scritto:

> Salve Renato,
>
> credo che tu stia confondendo due termini, entrambi di solito abbreviati in
> "wiki".
> Infatti, da un lato, è vero che un wiki è uno strumento adatto alla
> scrittura collaborativa di ipertesti, ma quando diciamo questo intendiamo
> il software "*mediawiki*", non il progetto "*wikipedia*" che ne è la più
> famosa applicazione.
> Pertanto, mentre un (media)wiki può davvero essere lo strumento adatto a
> quello che intendi fare, non lo è invece wikipedia (che è un'enciclopedia,
> i cui contenuti sono basati sul concetto di rilevanza enciclopedica,
> qualcosa di traducibile con "Interesse collettivo").
>
> Operativamente, se gestite un vostro server http, dovreste essere in grado
> di installare e configurare una vostra istanza del software mediawiki (che
> è open source) [1]. Se usate un server commerciale, credo che molti
> permettano l'installazione di mediawiki con una procedura automatica.
>
> Non mi dilungo oltre e ti invito a non indirizzare il resto di questa
> discussione a questa mailing list che, invece, è proprio dedicata a
> wikipedia. (E nemmeno a me che, in realtà, non ho mai installato un
> mediawiki *in house *:))
>
> Saluti
>
> Nicola // quatar
>
> [1] https://www.mediawiki.org/wiki/MediaWiki
>
> 2016-08-31 9:08 GMT+01:00 Renato Pontefice via WikiIT-l <
> [hidden email]>:
>
> > Salve,
> > come da oggetto, dovrei redigere la documentazione di uno specifico
> > progetto software. Questo progetto viene redatto da più persone. dovrei
> > redigere la documentazione. Ho pensato ad un wiki, poichè, ciascun
> > sviluppatore può scrivere cio di cui è responsabile.
> > Può essere esportato il contenuto in più formati (pdf, html
> > principalmente).
> > Sono arrivato a wikipedia, dopo aver fatto anche altre analisi.
> > La mia domanda è:
> > è questo lo strumento adatto? O ne esistono di altri, magari più mirati?
> >
> > Grazie
> >
> > Renato
> > _______________________________________________
> > WikiIT-l mailing list
> > [hidden email]
> > Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/
> > mailman/listinfo/wikiit-l
> >
> _______________________________________________
> WikiIT-l mailing list
> [hidden email]
> Pagina per iscriversi/disiscriversi:
> https://lists.wikimedia.org/mailman/listinfo/wikiit-l
>
_______________________________________________
WikiIT-l mailing list
[hidden email]
Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: redazione documentazione:è wikipedia lo strumento giusto?

Italian Wikipedia mailing list
In reply to this post by Italian Wikipedia mailing list
Uso con sucesso dal 1912: http://www.pmwiki.org/
Saluti Peter

Il giorno 31-ago-2016, alle ore 10.08, Renato Pontefice via WikiIT-l ha scritto:

> Salve,
> come da oggetto, dovrei redigere la documentazione di uno specifico
> progetto software. Questo progetto viene redatto da più persone. dovrei
> redigere la documentazione. Ho pensato ad un wiki, poichè, ciascun
> sviluppatore può scrivere cio di cui è responsabile.
> Può essere esportato il contenuto in più formati (pdf, html principalmente).
> Sono arrivato a wikipedia, dopo aver fatto anche altre analisi.
> La mia domanda è:
> è questo lo strumento adatto? O ne esistono di altri, magari più mirati?
>
> Grazie
>
> Renato
> _______________________________________________
> WikiIT-l mailing list
> [hidden email]
> Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l

______________________________________
Peter Forster, v. Castelrotto 18, 6600 Locarno
[hidden email]  |   079 620 48 61
Medicina popolare, fitoterapia, terapie corporee

Domini MedPop:
Enciclopedia | Medicina popolare | Squadra di Galenica | Galenica domestica | Lavoro corporeo | Terapisti complementari
Blogs: Facebook | Novità | Forum | Abstracts | Grafica
Redazione: Redazione bozze | Sito privato | Ultime attività MedPop

Unsubscribe

_______________________________________________
WikiIT-l mailing list
[hidden email]
Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: redazione documentazione:è wikipedia lo strumento giusto?

Italian Wikipedia mailing list
In reply to this post by Italian Wikipedia mailing list
Renato Pontefice via WikiIT-l, 31/08/2016 10:08:
> è questo lo strumento adatto? O ne esistono di altri, magari più mirati?

Abbiamo alcune pagine che provano a rispondere:
* https://www.mediawiki.org/wiki/Manual:What_is_MediaWiki%3F/it
*
https://www.mediawiki.org/wiki/Manual:Deciding_which_wiki_software_to_use/it

Per scrivere documentazione è difficile che ci sia uno strumento
migliore di un wiki e di MediaWiki in particolare, a mia opinione; se
però il software in questione è estremamente semplice, potrebbero
bastare approcci piú semplicistici.

Nemo

_______________________________________________
WikiIT-l mailing list
[hidden email]
Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: redazione documentazione:è wikipedia lo strumento giusto?

Italian Wikipedia mailing list
In reply to this post by Italian Wikipedia mailing list
Il giorno mer 31 ago 2016 alle ore 10:19 Renato Pontefice via WikiIT-l <
[hidden email]> ha scritto:

> è questo lo strumento adatto? O ne esistono di altri, magari più mirati?
>

Adatto MediaWiki lo è senz'altro. Ci sono però cose altrettanto adatte, più
mirate e spesso più semplici. Trovo sia ottimo DokuWiki [1], ad esempio,
che è pensato appositamente per la documentazione.

[1] <http://dokuwiki.org>
_______________________________________________
WikiIT-l mailing list
[hidden email]
Pagina per iscriversi/disiscriversi: https://lists.wikimedia.org/mailman/listinfo/wikiit-l
Loading...