Manuale: differenze tra le versioni

Versione delle 22:10, 24 mag 2013

Versione attuale delle 10:22, 8 set 2025

(49 versioni intermedie di 28 utenti non mostrate)

Riga 1:

{{Nota disambigua|la tastiera degli strumenti musicali|Manuale (organo)}}

{{F|informatica|agosto 2009}}

{{WF|informaticaeditoria|febbraioluglio 20132016}}

[[File:Bernoullis Vademecum des Mechanikers.jpg|right|thumb|''Vademecum des Mechanikers'' del [[Bernoulli (famiglia)|Bernoulli]], quindicesima edizione, edito a [[Stoccarda]] nel 1874.]]

Il '''manuale''' (sinonimo arcaico '''enchiridio''': entrambi i termini significano "da tenersi in mano") è un [[documento]], cartaceo o elettronico, volto a spiegare il [[funzionamento]] di un [[prodotto (commercio)|prodotto]], [[Macchina|dispositivo]] o [[servizio]].

Un '''manuale''' è un'opera che compendia gli aspetti essenziali di una determinata disciplina o di un argomento, generalmente in funzione delle esigenze divulgative o didattiche del pubblico al quale è destinata<ref>Giuliano Vigini, ''Glossario di biblioteconomia e scienza dell'informazione'', Milano 1985, pag. 70.</ref>.

Il termine è la traduzione {{Greco antico|Ἐγχειρίδιον|enchiridion|nopunti=X|da=X}}, che indica un oggetto da tenere a portata di mano (''en-cheir''); la fortuna del termine si deve alla grande diffusione del testo filosofico stoico ''[[Manuale di Epitteto]]'' ({{Greco antico|Ἐγχειρίδιον Ἐπικτήτου|Enkheirídion Epiktḗtou}}), una raccolta di massime da tenere sempre presenti.<ref>https://www.treccani.it/enciclopedia/manuale/</ref> La coniazione del termine italiano si attribuisce a [[Ulrico Hoepli]], mentre [[Giuseppe Colombo (ingegnere)|Giuseppe Colombo]] fu autore del famoso ''Manuale dell'ingegnere''.

== Tipologie di manuali ==

Si definisce manuale un [[libro]] che presenta sommariamente i temi più importanti di una determinata disciplina (ad esempio un manuale di storia della letteratura italiana è un libro destinato agli studenti liceali o universitari di letteratura italiana, ecc.)

== Terminologia sinonomica ==

Si chiamano manuali anche [[Pubblicazione tecnica|pubblicazioni tecniche]] relative a un prodotto commerciale.

Può essere detto anche ''vademecum'' (dal [[lingua latina|latino]] "''vade mecum"'' che significa "''va' con me"'', con il significato figurativo ''ti do una mano''): si tratta di una guida o formulario contenente le nozioni più importanti di un argomento generale ([[scientifico]], [[tecnico]], [[arte|artistico]]…), un [[compendio]] di informazioni riguardanti un particolare campo o tecnica, creato per fornire risposte rapide e concise su un particolare argomento.<ref>{{cita web|url=http://www.treccani.it/vocabolario/vademecum/|titolo=Vademecum|editore=Enciclopedia Treccani, vocabolario online}}</ref>

Per uno stesso prodotto possono essere redatti diversi tipi di manuale, destinati a diverse categorie di utilizzatori.

Coin ''manuale dell'utente'', o ''guida all'uso'', s'intende la pubblicazione tecnica che contiene le informazioni utili al corretto utilizzo di un dispositivo, di un [[attrezzo]] o di un utensile.

* '''Manuale utente''': destinato all'utilizzatore finale del prodotto, che si presuppone privo di competenze tecniche specifiche. Spesso questa è l'unica documentazione allegata ai prodotti di consumo.

* '''Istruzioni di montaggio''', allegate a prodotti che l'utente deve montare, ad esempio alcune categorie di mobili.

* '''Manuale dell'installatore''', destinato a chi deve installare un apparato o strumento, che poi sarà utilizzato da altri.

* '''Manuale dell'operatore''': destinato all'utilizzatore di uno strumento specialistico, ad esempio uno strumento elettronico di misura, in cui si presuppone una competenza specifica dell'utilizzatore.

* '''Manuale di servizio''', necessario al personale preposto all'assistenza, per gli interventi di manutenzione, [[taratura]] periodica, e ricerca guasti. Riporta informazioni tecniche specifiche non necessarie per il normale utilizzo del prodotto.

== Tipologie di manuali ==

Nel caso dei prodotti informatici, si possono individuare alcune categorie più specifiche di manuali:

[[File:Original packaging, cardboard box for the Mettoy Minor toy typewriter with instructions for use.jpg|thumb|Istruzioni originali per l'uso di un'antica macchina da scrivere giocattolo Mettoy Minor.]]

* '''Manuale Utente''', che quando è realizzato in formato elettronico è detto anche '''Help in linea'''.

Vi sono diversi tipi di manuali cartacei od in formato elettronico, a seconda del tipo di prodotto o servizio, di seguito alcuni esempi:

** '''Help contestuale''', ovvero l'insieme dei messaggi di aiuto che l'utente riceve automaticamente o a richiesta, e che sono collegati alla specifica sezione del [[Programma (informatica)|programma]] che l'utente sta utilizzando.

* Manuali per studenti.<ref>{{Cita web|lingua=it-it|url=https://www.historialudens.it/news/414-lezione-4a-il-manuale.html|titolo=Lezione 4a. Il manuale|sito=www.historialudens.it|data=2021-03-14|accesso=2025-08-28}}</ref>

* '''Manuale dell'Amministratore di sistema''', destinato a chi ha la responsabilità di installare il prodotto su uno o più [[computer]], configurarlo, installare gli aggiornamenti, risolvere i malfunzionamenti e garantirne il buon funzionamento nel tempo.

* Manuali di istruzione:<ref>{{Cita web|lingua=it-IT|url=https://www.spai-srl.com/breve-storia-del-manuale-istruzioni/|titolo=Breve storia del manuale istruzioni|sito=SPAI|data=2019-09-19|accesso=2025-08-28}}</ref>

* '''Manuale di personalizzazione''': alcuni prodotti complessi, ad esempio programmi di contabilità, archivio, magazzino, richiedono un importante lavoro di configurazione e personalizzazione per adattarli all'utilizzo a cui sono destinati. Questa attività richiede una competenza specifica sul programma, che viene riassunta in questo manuale.

** '''Manuale utente''': destinato all'utilizzatore finale del prodotto, che si presuppone privo di competenze tecniche specifiche. Spesso questa è l'unica documentazione allegata ai prodotti di consumo. Quando è realizzato in formato elettronico è detto anche ''Guida'' o ''Aiuto''.

* '''Manuale dell'Amministratore del servizio''', destinato a chi deve gestire un servizio dal punto di vista dei contenuti applicativi, ad esempio il gestore di una [[mailing list]] o di un [[forum (internet)|forum]], che può avere la responsabilità di moderare i contenuti inseriti dagli utenti.

*** '''Help contestuale''', ovvero: l'insieme dei messaggi di aiuto che l'utente riceve automaticamente o a richiesta, e che sono collegati alla specifica sezione del [[Programma (informatica)|programma]] che l'utente sta utilizzando.

* '''Manuale del programmatore''', documento che descrive l'organizzazione del [[codice sorgente]] del programma, destinato a chi dovrà effettuare modifiche nel programma stesso.

** '''Istruzioni di montaggio''',: allegate a prodotti che l'utente deve montare, ad esempio alcune categorie di mobili.

* '''Manuale delle [[Application programming interface|API]]''': questo tipo di manuale descrive le modalità di utilizzo di un componente software come una [[libreria software]] o una [[classe (informatica)|classe]], ed è destinato a chi deve utilizzare questo componente in un programma, senza doverne per forza conoscere tutte le caratteristiche interne.

** '''Manuale dell'installatore''',: destinato a chi deve installare un apparato o strumento, che poi sarà utilizzato da altri.

** '''Manuale dell'operatore''': destinato all'utilizzatore di uno strumento specialistico, ad esempio uno strumento elettronico di misura, in cui si presuppone una competenza specifica dell'utilizzatore.

** '''Manuale di servizio''',: necessario al personale preposto all'assistenza, per gli interventi di manutenzione, [[taratura]] periodica, e ricerca guasti. Riporta informazioni tecniche specifiche non necessarie per il normale utilizzo del prodotto.

Nel caso dei prodotti informatici, si possono individuare alcune categorie più specifiche di manuali:

* '''Manuale dell'Amministratoreamministratore di sistema''', destinato a chi ha la responsabilità di installare il prodotto su uno o più [[computer]], configurarlo, installare gli aggiornamenti, risolvere i malfunzionamenti e garantirne il buon funzionamento nel tempo.

* '''Manuale di personalizzazione''': alcuni prodotti complessi, ad esempio programmi di contabilità, archivio, magazzino, richiedono un importante lavoro di configurazione e personalizzazione per adattarli all'utilizzo a cui sono destinati. Questa attività richiede una competenza specifica sul programma, che viene riassunta in questo manuale.

* '''Manuale dell'Amministratoreamministratore del servizio''', destinato a chi deve gestire un servizio dal punto di vista dei contenuti applicativi, ad esempio il gestore di una [[mailing list]] o di un [[forum (internetInternet)|forum]], che può avere la responsabilità di moderare i contenuti inseriti dagli utenti.

* '''Manuale del programmatore''', documento che descrive l'organizzazione del [[codice sorgente]] del programma, destinato a chi dovrà effettuare modifiche nel programma stesso.

* '''Manuale delle [[Application programming interface|API]]''': questo tipo di manuale descrive le modalità di utilizzo di un componente software come una [[Libreria (software)|libreria software]] o una [[classeClasse (informatica)|classe]], ed è destinato a chi deve utilizzare questo componente in un programma, senza doverne per forza conoscere tutte le caratteristiche interne.

== Galleria ==

<gallery>

File:Oxygen480-categories-system-help.svg|L'icona di un [[punto interrogativo]], viene molto spesso utilizzata nelle [[Interfaccia grafica|interfacce grafiche]] o in determinati pulsanti fisici (come ad esempio nei [[Telecomando|telecomandi]]) per richiamare un menù di aiuto, o una guida su schermo.

File:Office-book.svg|L'icona di un libro viene anch'essa utilizzata per rappresentare una guida interattiva, l'icona è un riferimento ai manuali cartacei.

File:Gnome-help-browser.svg|L'icona di un salvagente è anch'essa utilizzata per rappresentare una guida, anche se più raramente.

</gallery>

==Note==

<references/>

== Voci correlate ==

* [[FAQDocumentazione tecnica]]

* [[Frequently asked questions]]

* [[Ulrico Hoepli]], a cui si attribuisce il conio del termine

* [[Technical writer]]

* [[Giuseppe Colombo (ingegnere)|Giuseppe Colombo]], autore del famoso "Manuale dell'ingegnere"

== Altri progetti ==

Riga 33 ⟶ 49:

== Collegamenti esterni ==

* {{ThesaurusCollegamenti BNCFesterni}}

{{Controllo di autorità}}

{{Portale|editoria}}

[[Categoria:DocumentazioneOpere informaticaletterarie per tipo]]

[[Categoria:Guide]]