In questo post torniamo ad affrontare un argomento molto importante: Le traduzioni della documentazioni e come possiamo avere a disposizione su Confluence.

Riprendiamo l’argomento

Avevamo iniziato a parlare di traduzione in questo post, dove abbiamo descritto come poter tradurre diverse componenti di Jira per aiutare gli amministratori di Jira nella traduzione di bottoni, checkbox, etc.

Oggi come oggi, le lingue sono entrate nel lavoro di tutti i giorni perchè le aziendedi oggi hanno la necessità di comunicare in diverse lingue. Gli scenari sono diventati questi: Società italiana, software factory in Romania o Portogallo o Spagna e controllo qualità in Germania.

Utilizzare Jira e Confluence permette di coordinarsi e condividere le informazioni. Jira ci permette di poter sincronizzare il gruppo di lavoro, ovunque nel mondo, mentre Confluence permette di gestire la documentazione di lavoro. Il tutto solitamente nella lingua Inglese, che adesso è la lingua franca a livello mondiale. Il problema sorge nei seguenti ambiti:

• condivisione di manualistica con persone di uno specifico paese (ad esempio quando si vuole condividere la manualistica di un software in una altra lingua)
• Condivisione di alcune documentazioni con una rete di vendita di un altro paese (ad esempio la rete di vendita in Germania di un prodotto Italiano).
• Condivisione di documenti da altra lingua (ad esempio la traduzione Italiana di documenti in altra lingua quali atti legali, documentazione del paese in cui si vuole vendere il/i prodotto/i, etc).

Comunicare con tutte queste lingue non è affatto facile. Non basta una traduzione letterale della frase. Anzi: questa potrebbe essere causa di problemi perché le lingue non sono come i linguaggi di programmazione, ma sono un argomento molto complesso.

Ho esperienza diretta con la lingua Portoghese e non sempre la traduzione letterale ha senso nella lingua in cui si vuole tradurre . In aggiunta posso affermare che alcuni termini, che possono essere utilizzati senza problemi in Portogallo, in Brasile potrebbero causare un problema non da poco, e viceversa. Questo ovviamente. non aiuta moltissimo.

Ma ho anche conoscenza di espressioni simili anche con la lingua Inglese (differenze tra Inglese Americano e Inglese UK), che causano lo stesso effetto…. indesiderato. La traduzione deve essere sempre eseguita con determinati criteri e non deve essere presa a cuor leggero.

Confluence è uno ottimo strumento per realizzare e condividere la documentazione aziendale, a vari livelli e con tantissime possibilità. Nei vari post di questo blog ho descritto come può aiutarci e negli articoli che ho dedicato ad ECM ho evidenziato come questi prodotti possono essere utilizzati per realizzare un ECM – Enterprise Content Management, sfruttando diversi addon che completano le funzioni di Confluence in maniera egregia.

Tuttavia, le funzioni out-of-the-box di Confluence non sono molto agevoli per il lavoro di traduzioni di pagine o altro….. ma gli addon ci danno una mano 🙂

Su Confluence abbiamo un primo aiuto, che ci permette di aggiungere una funzione di traduzione, basandoci sui traduttori automatici e sui loro servizi (anche questo blog si serve di questi). Si tratta di un addon, della svizzera EPS che mette a disposizione tali funzionalità, che si appoggiano su traduttori automatici, e ci permettono di tradurre i contenuti delle pagine di Confluence.

I traduttori automatici

Già da diversi anni sono disponibili sul mercato diversi tool quali Google Translate e DeepL, che forniscono un valido aiuto nella traduzione. Questi tool ci permettono di tradurre delle frasi o dei testi più complessi in maniera semplice, ma prestiamo attenzione.

Questo articolo del Blog di Paolo Attivissimo fornisce un grande aiuto nel comparare i due strumenti e come funzionano, mostrandone diversi aspetti. Non è l’unico articolo in cui si parla di traduzioni e vi consiglio di leggerli: le informazioni che Paolo Attivissimo mette a disposizione sono molto utili :-).

Anche questo blog si serve di un addon WordPress che permette di poterlo tradurre e, da quanto mi hanno riferito alcuni lettori esteri, sembra valido, ma come sempre cerco di prestare attenzione a come scrivo, usando frasi semplici. In questo modo la traduzione dovrebbe risultare abbastanza sicura, o almeno lo spero.

Come funziona questo addon?

Questo addon mette a disposizione una funzione dedicata, su ogni pagina.

Un semplice click ci permette di tradurre una pagina facilmente, appoggiandosi ai sistemi di traduzione automatica, ma non solo.

Possiamo anche correggere la traduzione, eliminando eventuali errori eseguiti dal sistema di traduzione automatica, non necessariamente commessi per errori di programma: un programma al momento non riesce a tradurre il tono ironico, un modo di dire tipico di una determinata regione o città, etc.

Abbiamo a disposizione diverse lingue gestite. La configurazione generale risulta molto semplice da usare.

Ultima ma non ultima, possiamo anche tradurre i testi all’interno di grafici di Draw.io, e questo ci aiuta parecchio.

Conclusione

Abbiamo affrontato un argomento importante e abbiamo mostrato una prima soluzione. Nei prossimi post proveremo ad approfondire questo argomento testando l’addon e verificando se esistono anche altre soluzioni. Come sempre cerchiamo di capire come possiamo sopperire alle nostre necessità sfruttando diverse possibilità e, grazie alla grande varietà di addon che il marketplace offre, abbiamo sempre grandi possibilità.

Reference

Maggiori informazioni sono presenti nella pagina del marketplace.

In questo post ci prefiggiamo uno scopo molto difficile e di non facile spiegazione, ovvero come applicare i principi della metodologia AGILE al SINGOLO. Ovvero, quando si è freelance o banalmente dei Liberi Professionisti.

In questo caso vogliamo vedere come possiamo, anche se il TEAM è formato da una singola persona, migliorare la nostra vita lavorativa sfruttando i principi dell’AGILE.

Set Esplorazione mode = ON

Stato iniziale

Essendo Freelance, possiamo affermare con estrema sicurezza che non possiamo ricoprire tutti i ruoli che si hanno a disposizione nella metodologia Agile. Non possiamo usufruire di questa situazione e di conseguenza, anche se ricopriamo i ruoli in diversi momenti della giornata, non possiamo sfruttare i vantaggi che ci può offrire.

Ragionando vediamo che la metodologia mette a disposizione non solo ruoli, ma ci mette a disposizione (come dice il nome stesso) una metodologia, un modo di ragionare e di mettere in ordine le cose.

La prima cosa da fare è dotarsi di uno o più strumenti che ci permettono di organizzarci e di mettere ordine. A tale scopo, i prodotti Atlassian, nella versione Cloud, sono sicuramente quelli che meglio possono aiutare., perchè ci mettono a disposizione tutto ciò che ci serve:

• Confluence, per memorizzare la nostra documentazione
• Jira, per memorizzare le nostre attività.

L’essere cloud ci favorisce, in quanto, letteralmente, basta avere una connessione internet per poter accedere e vedere i dati, i file che sono memorizzati. In aggiunta, l’uso di un TABLET o di un Cellulare, laddove possibile, per gestire le varie informazioni di cui abbiamo bisogno.

Questo ci favorisce nel reperire le informazioni ovunque ci troviamo. L’essere Freelance ci porta ad essere sempre in movimento: Letteralmente inseguiamo i clienti. DI conseguenza abbiamo bisogno di poter montare il nostro ufficio …. ovunque.

La nostra fonte di ispirazione

L’ho citato negli articoli di ECM, oltre che nei vari corsi su Confluence che svolgo nelle varie aziende. l’Accampamento Romano. Vi propongo un semplice esempio pratico.

La citazione non è mia, ma è presa in prestito da un famoso storico italiano. Un Legionario Romano, poteva trovarsi in qualsiasi parte dell’Impero, ma :

• sapeva dove era la mensa
• sapeva dove si trovava l’armeria
• dove prestare servizio
• dove iniziava e smontava il turno di guardia
• come andare in battaglia

Di conseguenza il primo consiglio: ESSERE ORDINATO E SFRUTTARE TUTTI GLI STRUMENTI DI CUI ABBIAMO BISOGNO AL MEGLIO.

Prima di tutto

Organizziamo le nostre attività su Jira, sfruttando un progetto Jira, dove:

• ogni singola issue rappresenta una specifica attività. Di conseguenza, se sfruttiamo una opportuna configurazione delle issue type, possiamo classificarcele.

• Usare le Component per ulteriori classifcazioni. Possiamo usarlo anche per definire i clienti. Da li possiamo anche sfruttare il JQL e le BOARD per classificare ulteriormente le issue.

• Sfruttare sempre il JQL, perchè ci permette di poter ricavarci le informazioni che ci servono. ma non solo 🙂

Questo primo passo ci permette di poter trovar le informazioni che ci servono senza impazzire. Non è da poco.

Che altro?

Sfruttare la possibilità di poter prendere appunti e memorizzarli nelle pagine di Confluence.

In questo ci aiutano tantissimo Space e template di Pagine. Possiamo creare delle pagine con tutte le indicazioni che ci servono e poi classificarle attraverso:

• metadati da associare alla pagina. In questo caso abbiamo diverse opzioni
• Label, che ci aiutano a classificare le pagine
• Space che possono fungere da blocchi note ben definiti.
• Addon che ci permettono di poter creare dei Log Activity, come abbiamo descritto in questo Post.

Per fare ciò possiamo sfruttare un Tablet (molto più leggero di un portatile) e che ci risolve diversi problemi.

Ma questo ci permette anche di ….

… di creare delle retrospettive. Fondamentalmente si tratta di fare una analisi critica dei problemi, che si sono verificati al termine di uno sviluppo/iterazionen, cercare di sviscerare le cause e da li, arrivare a soluzioni che risolvano il problema.

Consiglio una lettura, che trovo molto interessante in quanto mette a disposizione uno specchietto molto semplice e diretto.

In questo caso, invece di realizzare queste Retrospettive dopo una iterazione, procediamo dopo diverse altre situazioni:

• risoluzione di una problematica sollevata da un cliente;
• contestazione sollevata da un cliente;
• aver identificato delle situazioni problematiche che si presentano a cadenze regolari;
• difficoltà ad acquisire un nuovo cliente o difficoltà a mantenerlo;

In questo caso si tratta di fare una cosa che i freelance fanno molta molta fatica: Fermarsi e ragionare su di un aspetto che riguarda le proprie procedure di lavoro. Eppure una cosa che ho notato per mia esperienza personale, se riesco a ragionare in queste prospettive, si riesce ad identificare delle problematiche e a risolverle.

Conclusione

Abbiamo presentato un esempio di come, alcune tecniche di AGILE, possono aiutarci nel migliorarci e rimuovere problematiche varie, mettere ordine in varie parti e, unendo l’utilizzo dei prodotti Atlassian, quello che otteniamo è un risultato vincente :-).

In questo post andiamo ad analizzare un addon con funzionalità interessanti. Andiamo ad esaminarlo descrivendole.

Subito al dunque

Questo addon permette di aggiungere delle componenti che possiamo modifciare…. senza modifciare la pagina.

queste componenti si definiscono in maniera molto semplice, come mostrato dalla segiente figura:

Mooooooolto interessante

Questo è il secondo addon che permette di poter definire una caratteristica di questo genere, ma sopratutto di poter inserire dei dati senza dover andare in editazione della pagina.

Aggiungo una cosa. LO PROVIAMO SUBITO.

Installazione

Come sempre ci facciamo aiutare da una agevole GIF per descrivere l’installazione.

Configurazione generale

Con somma gioia, non abbiamo alcuna sezione di configurazione

Test

Per il test predisponiamo uno Space ad hoc, dove impostare le varie macro che l’addon mette a disposizone, e sono tanti

A questo punto, andiamo ad aggiungere alcune di queste macro e poi andiamo a vedere, sempre tramite agevole GIF, il primo risultato

Ma notiamo una cosa. Se salviamo dei valori o delle scelte….. queste PERMANGONO

SPETTACOLO

Abbiamo un addon fenomenale. Possiamo utilizzarlo in molteplici soluzioni, possibilità o altro. Lasciate correre la fantasia.

Possiamo usarlo per impostare dei dati e, proprio per il fatto che viene memorizzato, possiamo usarlo per memorizzare e abbiamo anche lo storico. La seguente GIF:

ci mostra come memorizza. Semplicemente memorizza delle versioni di PAGINE. Geniale. Geniale ed ancora Geniale.

Conclusioni

Abbiamo un addon fenomenale. Possiamo usarlo in vari ambiti quali, ad esempio:

• Log activity – Possiamo creare delle pagine dove andare a memorizzare delle variazioni, senza andare a modificare le pagine
• Sondaggi – Creare delle semplici pagine di Sondaggio
• Cheklist – Creare delle semplici checklist.
• FANTASIA. SCATENATEVI.

Reference

Maggiori informazioni sono reperibili alla pagina del marketplace.

Mi sono occupato di questo argomento in diverse occasioni, in questo blog. Adesso iniziamo a visionare un ulteriore addon che ci permette di eseguire questa operazione.

Subito al dunque

Questo addon, come gli altri addon della EPS che abbiamo esaminato nei precedenti post, permette di poter configurare facilmente il template che vogliamo impostare

Consentendo di poter visionare facilmente l’anteprima della pagina che andremo ad esportare

Abbiamo la possibilità di inserire diverse ‘variabili’ nel template, in maniera semplice.

Il tutto in maniera visuale

Piacevolmente sorpresi

Questa prima esplorazione ci mostra un addon molto interessante. Nei prossimi post andremo a collaudarlo, verificandone dal vivo i risultati.

Reference

Maggiori informazioni sono presenti nella pagina del marketplace.

Andiamo a curiosare su di un addon che permette di poter maneggiare in maniera semplice, come lavorare su di un Foglio Excel, all’interno della nostra istanza di Confluence. Andiamo in esplorazione 🙂

Subito al dunque

Questo addon ci permette di poter intervenire nei dati presenti nelle tabelle e di poter inserire dei calcoli 🙂

Il tutto inserendo una semplice formula, come siamo abituati con Ms Excel 🙂

Non solo, ma anche andando a importare i dati direttamente da MS Excel

ed inserire le formula in maniera semplice

Conclusioni

Interessante. Vedo diverse applicazioni di questo addon in vari ambiti lavorativi. Basti pensare quelle situazioni in cui si deve presentare dei risultati, in cui occorre inserire dei calcoli particolari.

Reference

Maggiori informazioni sono reperibili alla pagina del Marketplace.

In questo post andremo ad esaminare un addon interessante e che promette molto bene. Andiamo a curiosare 🙂

Page Fields

SI tratta di un addon per Confluence che permette di poter aggiungeer delle informazioni, leggersi Metadati, alle pagine di Confluence.

Come possiamo vedere dalla seguente immagine:

questo addon mette a disposizione delle macro che permette di definire questi metadati

Da li poi abbiamo a disposizione delle REST API che ci permette di poter le leggere e riutilizzare per varie operazioni

NB: Una piccola precisazione

Questo addon è stato sicuramente ispirato dal lavoro di un grande amico, a cui dedico un ringraziamento speciale. Dalla prima immagine che ho postato si vede il suo nome. Sto parlando di Claudio Ombrella. Un Amico ed un esperto dei prodotti Atlassian. Grazie Claudio per il tuo grande Lavoro 🙂

Reference

Maggiori informazioni sull’addon sono reperibili alla seguente pagina del marketplace. Aggiungo che non vedo l’ora di provarlo.

In questo post proseguiamo l’esplorazione di addon che ci aiutano nel creare di pagine Confluence partcolari, accattivanti e con funzionalità …. interessanti. Andiamo a sperimentare.

Funzioni interessanti

Questo addon mette a disposizione diverse macro che ci permettono di aggiungere degli effetti interessanti, Se le andiamo ad esaminare possiamo:

Possiamo gestire gli stati dei task direttamente con un click el mouse.

Possiamo creare delle CARD da poter utilizzare per mostrare delle schede di informazioni.

Aggiungere dei tooltip ai vari elementi della pagina

Gestire in maniera molto semplice dei reminder

oltre cghe gestire in maniera semplice anche la differenza di versione.

Usare delle gallerie di immagini semplici e carinissime

Aggiungere dei link come se fossero dei bottoni.

Migliorare la gestione dei task Confluence

Editing delle date senza editare la pagina …. una caratteristica interessante

Conclusione

Questo addon estende le possibilità di migliorare e organizzare le pagine di Confluence in pocbi click. Non vedo l’ora di provarlo.

Reference

Maggiori informazioni alla pagina del marketplace o al seguente articolo del blog della Stiltsoft.

In questo post andremo a testare questo addon della Old Street Solutions che permette di aggiungere grafici su Confluence. Andiamo a curiosare come sempre 🙂

Installazione

Partiamo come sempre dalla installazione. Sfruttiamo come sempre da una GIF che ci aiuta nel descrivere come installare l’addon.

Configurazione

Procediamo con la configurazione generale dell’addon e con somma gioia apprendiamo che non ne abbiamo…. Passiamo subito all’utilizzo.

Test

Procediamo con il test. IN questo caso andiamo a realizzare un grafico dei dati delle mie fatture di acquisto del 2018. Voglio visualizzare un grafico su questi dati, e questo è il risultato:

Si tratta delle fatture di acquisto della mia attività, spese che ho sostenuto nell’anno 2018 e che normalmente mi rappresento come una list aaggregata attraverso un altro addon: SUMUP:

Dalla precedente immagine, potete vedere come ho riclassificato le issue di un progetto in modo da poter rappresentare le mie fatture di acquisto. Adesso proviamo a sfruttare questo nuovo addon, per cercare di rappresentare in altro modo le mie spese di acquisto.

PS: I dati che vedete sono ovviamente un sottoinsieme: Ho rimosso diverse informazioni.

Per inserire i dati nelle nostre pagine Confluence, basta semplicemente aggiungere una macro, che l’addon, mette a disposizione:

Una volta selezionato, possiamo configurare la query JQL (e qui divento molto sensibile) per selezionare i dati da raffigurare

Possiamo quindi rappresentare dei dati da Jira sul nostro Confluence, usandolo come sempre come punto centrale della condivisione delle informazioni in ambito aziendale, dei progetti di Jira (siano essi progetti di sviluppo software che progetti che sono stati rimappati con altri obbiettivi).

Il risultato lo abbiamo visto nella prima immagine del test:

Conclusioni

Abbiamo visionato un addon mooooooooooolto carino. In primis, ci permette di rappresentare i dati di un progetto/di una interrogazione JQL su Confluence. Secondo, è facilissimo da usare. Lo consiglio.

Reference

Maggiori informazioni sono presenti nella pagina del Marketplace.

https://marketplace.atlassian.com/apps/1220925/custom-charts-for-jira?hosting=server&tab=overview

In questo post andiamo a ‘collaudare’ un addon che ci permette di risolvere l’annoso problema della condivisione di una pagina del nostro Confluence CLOUD, senza dover spendere tantissimo e senza ….. complicarsi la vita. Procediamo

Installazione

Ci serviamo come sempre di una GIF per mostrare come eseguire l’installazione.

Configurazione

Anche in questo caso abbiamo una buona notizia. Non abbiamo una sezione di configurazione generale.

Test

Andiamo a provare subito l’addon. Per questo creiamo uno Space dedicato dove andiamo ad inserire una pagina con alcune informazioni di prova.

A questo punto, una volta che lo space è creato, procediamo con la generazione della condivisione. Ci facciamo aiutare nella generazione di una condivisione.

Ci siamo mandati una mail per segnalare la condivisione, e questo è il risultato:

Per verificare il funzionamento, simulando apriamo una finestra in navigazione anonima oppure apriamo un nuovo browser (ad esempio, dato che usiamo prevalentemente Chrome, Firefox)

Il risultato è il seguente:

Come possiamo vedere abbiamo a disposizione una pagina web, in tutto e per tutto uguali alla originaria, come mostrato in figura.

Quello che notiamo è:

• assenza della barra laterale. Non serve alla persona cui condividiamo la pagina
• la formattazione potrebbe risultare più dilatata.
• Possiamo inserire i commenti (come da configurazione)
• Possiamo accedere a tutto il contenuto della pagina

La seguente GIF da un esempio di Commento

Lato nostro ,questo è il risultato.

Ovviamente un apposito messaggio di posta elettronica viene inviato all’autore per indicare che è stato postato un commento:

SPETTACOLO

Abbiamo FINALMENTE LA SOLUZIONE CLOUD al problema pluriannuale. Sono Stracontento anzi lo sono ancora di più: Raggiante di gioia.

Ringrazio fin da adesso i ragazzi della Old Street Solutions Ltd. per il lavoro Straordinario che mettono a disposizione degli utenti che da anni, a viva voce, chiedevano la soluzione a questo problema.

Reference

Maggiori informazioni sono reperibili alla pagina del marketplace. Consiglio anche la lettura della manualistica.

ANNUNTIO VOBIS GAUDIUM MAGNUM…….

In questo post andremo a introdurre una soluzione che ci permette di risolvere un annoso problema. SI tratta della possibilità di poter condividere delle pagine di Confluence CLOUD con altri utenti esterni (ovvero utenti che non possono accedere al nostro Confluence).

Scenario

lo scenario è il seguente: Usiamo Confluence per redigere la nostra documentazione e abbiamo la necessità di dover cndividere una pagina con un nostro cliente. Abbiamo due possibilità:

• Condividiamo uno space rendendolo pubblico
• Attiviamo una nuova utenza.

In entrambi i casi abbiamo un problema. Nel primo caso, potremmo condividere troppo. Nel secondo caso dobbiamo ‘spendere’ dei soldi per questo e, non sempre è conveniente.

Gli utenti chiedono

… a viva voce da 10 anni ed il risultato è questa segnalazione https://jira.atlassian.com/browse/CONFCLOUD-32999 che purtroppo ha dato diversi problemi. La Atlassian ha messo a disposizione questa funzione solo nel piano PREMIUM, molto più costoso.

Non tutto è perduto

Possiamo avere una soluzione proprio grazie alla Old Street Solutions Ltd. che ci mette a disposizione una soluzione. Mi permetto di riportare un loro intervento (E’ in inglese, ma merita ascoltarli).

Subito al dunque

Spieghiamo subito la loro soluzione senza indugio. Questo addon aggiunge la funzionalità richiesta (ad un costo umano) e permette di poter gestire anche i vari link che andremo a condividere. Questo addon mette a disposizione un link nella pagina confluence che permette di attivare la funzionalità:

da li possiamo attivare nuovi link e gestire quelli esistenti

ed inviarli via mail ai diretti interessati.

SPETTACOLO

Non posso che essere STRACONTENTO del risultato. Non vedo l’ora di provarlo. So già in quale contesto usarlo nel mio lavoro. Ringrazio fin da adesso i ragazzi della Old Street Solutions Ltd.

Reference

Maggiori informazioni sono reperibili alla pagina del marketplace. Consiglio anche la lettura della manualistica.