Una nuova esplorazione

Con questo post iniziamo una nuova esplorazione nel mondo dei Wiki. Affrontiamo uno dei problemi maggiori nel campo: Come andiamo a redigere una documentazione che abbia un senso e che permetta, un domani, di essere  condivisibile e permetta agli utenti di avere a disposizione un percorso di lettura valido, sensato e coerente.

Da cosa partire

Avere le idee chiare

La prima cosa che occorre fare è sicuramente cercare di classificare tutte le informazioni e gli utenti che andranno a referenziarle. In questo modo abbiamo riusciamo ad avere una prima indicazione di come classificare le informazioni, in quali SPACE andare a inserirle, se abbiamo bisogno di collegare delle informazioni, etc etc etc

Questo ovviamente è solo l’inizio. Occorre studiare bene questa prima parte, per un motivo molto semplice: Inserire delle informazioni a caso su di un Wiki non ha praticamente senso. Faccio un esempio molto semplice: Se si inseriscono delle pagine a caso e queste non sono collegate tra di loro (aggiungo anche: collegate in maniera opportuna, ma nella maniera più improbabile), questo significa che abbiamo solo un caos semi-disorganizzato, che non ci aiuta minimamente nel reperire le info. Passeremo le nostre giornate a ricercare le informazioni. Lo strumento non ci aiuterà in nessun modo 🙁 e la prima reazione sarà quella di copiare le informazioni in locale sul nostro PC/tablet.

Fate sempre ordine

Occorre studiare come inserire le informazioni e come organizzarle, classificarle, collegarle. Questo ultimo punto è sicuramente il più importante in quanto anche delle belle pagine chiare e illuminanti non hanno alcun senso se non sono collegate tra di loro. Occorre mettersi in testa che l’utente non deve fare la caccia al tesoro per reperire le informazioni.

Non seguire le mode…

Molto spesso si commette l’errore che basti introdurre lo strumento in azienda o semplicemente adottarlo per risolvere tutti i problemi di documentazione, come avevo già indicato in questo post, in cui ho riportato una prima serie di considerazioni sulla documentazione su Wiki.

Se le informazioni sono collegate in maniera tale da creare dei percorsi di lettura, quello che si ottiene è una documentazione valida.

Obbiettivo di questi post

Con questa nuova serie di post, ci prefiggiamo l’obbiettivo di fornire una serie di consigli per gli utenti, inteso più come un nuovo modo di ragionare e di organizzare le informazioni che porti gli utenti ad avere a disposizione una documentazione il più possibile fruibile ed utile.

Non intendo fornire tanto delle norme rigide ed immodificabili, ma quanto una serie di consigli e di punti di attenzione che possono aiutare nella redazione della documentazione e nell’organizzazione della stessa. La vera potenzialità dei prodotti Atlassian risiede proprio nel grado di libertà che si ha a disposizione 🙂

In conclusione

Chiudiamo qui questo post introduttivo. Abbiamo ripreso quanto avevo già indicato in altri post e cerchiamo di esploderlo nei prossimi post con esempi pratici, modalità di ragionamento e, importantissimo, uso corretto della testa 🙂

Criptazione delle informazioni

In questo post riprendiamo l’argomento dells sicurezza dei dati, andando ad esaminare un nuovo addon dedicato alla criptazione. Parleremo del Secure COntent

Quali funzionalità offre?

Come mostrato dalla seguente figura:

permette di poter eseguire la criptazione delle informazioni direttamente in fase di editazione delle pagine. Questo permette di poter proteggere in tempo reale le informazioni che riportiamo nelle nostre pagine confluence, facilmente e senza grossi problemi. Il risultato è il seguente:

Le macro che l’addon mette a disposizione permette di evidenziare oi contenuti criptati e di poterli decriptare (conoscendo ovviamente la password), mostrando il contenuto nascosto, come mostrato nella figura successiva:

Conclusioni

abbiamo a disposizione un addon molto interessante. Possiamo proteggere le nostre informazioni senza grandi complicazioni. Nei prossimi èpst andremo a testare questo addon, cercando come sempre di identificare pro e contro, vantaggi e svantaggi, punti di forza e debolezza.

Reference

Maggiori informazioni sull’addon sono presenti nella pagina del Marketplace.

Da esaminare cripta il contenuto di una pagina. Secure content e uno ma documentazione scarna. Poche funzioni.

https://marketplace.atlassian.com/plugins/dk.translucent.atlassian.confluence.crypto-plugin/server/overview sembra.

Versione Cloud

In questo post riprendiamo quanto abbiamo già pubblicato su Draw.io per versione Server, ed andiamo a eseguire un test anche per la versione cloud del prodotto.

Che funzionalità sono garantite?

Da una analisi della pagina del Marketplace, vediamo che sono garantite le medesime funzionalità della versione Server, con le stesse potenzialità e modalità di uso.

L’unica differenza, al momento riscontrata, è che questo addon è gratuito (Al momento in cui viene redatto il post per la prima volta). Direi che questo fa la differenza :-).

Installazione cloud

Per l’installazione dell’addon procediamo come siamo sempre abituati: Utilizziando la procedura guidata andiamo a cercare il nostro addon e selezioniamo Install:

Accettiamo le condizioni di licenza e procediamo con l’installazione vera e propria….

… attendiamo che sia completata la fase di installazione …

Una volta completate le varie fasi, viene visualizzato il seguente messaggio:

… e siamo quindi pronti ad usare il nostro nuovo addon.

Configurazione

Se facciamo riferimento alla precedente immagine, possiamo vedere che è presente il tasto Manage, che ci consente di poter accedere alla sezione di configurazione, mostrata dalla seguente immagine:

e come possiamo vedere, non abbiamo alcuna schermata di configurazione da gestire. Procediamo quindi con il test.

Test test test…. test

Per utilizzare la funzionalità basta semplicemente andare in editazione di una pagina e inserire la nuova macro Draw.io Diagram, come mostrato in figura (l’autocomposizione ci da un aiutino).

Una volta che la macro è aggiunta, procediamo con l’editazione: Selezioniamo l’oggetto e successivamente selezioniamo Edit:

Siamo subito reindirizzati nella form di generazione del grafico. Possiamo a questo punto sbizzarrirci nel generare tutti i grafici che vogliamo :-). Abbiamo solo l’imbarazzo della scelta :-D:

Per il resto non abbiamo cambiamenti sulle varie funzioni inerenti al disegno.

Conclusioni

Abbiamo visto con estremo piacere come la SIBERT/MEDIA ha messo a disposizione delle istance cloud il suo addon anche per Confluence. Restiamo in attesa di nuovi interessanti sviluppi 🙂

Reference

Maggiori dettagli sono reperibili alla pagina del marketplace di Atlassian.

Test su strada

In questo post andremo a testare questo addon.

Installazione

Partiamo sempre dalla installazione dell’addon. Partiamo dalla sezione di gestione degli addon e andiamo ad eseguire la ricerca:

Selezioniamo Free Trial, per eseguire l’installazione nella nostra istanza cloud.

Accettiamo selezionando Accept & Install per proseguire l’installazione. A questo punto parte l’installazione….

… che procede al download ed install del prodotto ….

… al suo completamento ….

… procede con la licenza (Vi ricordate che la installazione per cloud presenta alcune differenze?) …

… esegue l’aggiornamento delle licenze ….

…. rendendo l’addon disponibile …

A Questo punto possiamo usare l’addon 🙂

Configurazione

Non è presente alcuna form di configurazione e possiamo subito utilizzare questo addon direttamente nelle pagine.

Senza indugio… test test test 😀

Procediamo con il test.  Aggiungiamo subito la macro sulle nostre pagine …

… in maniera molto semplice, dove riportiamo un esempio direttamente dalla manualistica dell’addon. Il risultato è il seguente.

Conclusioni

Abbiamo visto un esempio di come possiamo includere del codice HTML sotto la nostra istanza Cloud. Immaginate che cosa possiamo fare :-).

Quiz per Confluence

In questo post andremo ad esaminare un addon molto particolare: Quiz per Confluence; che permette di poter realizzare delle cose molto interessanti.

Che cosa tratta l’addon?

L’addon consente di poter creare facilmente ed inserire su pagine Confluence dei Quiz e dei test, evidenziando come questi strumenti sono ideali per l’impiego didattico.

Possiamo costruirli in maniera molto semplice, sfruttando la facilità che Confluence mette a disposizione e a cui siamo abituati 

e con la stessa semplicità possiamo condividerli con gli altri utenti 

riuscendo addirittura a controllarli attraverso le schermate che l’addon mette a disposizione

Chi prepara i quiz dispone anche di una reportistica che lo aiuta nel capire il grado di preparazione

Conclusioni

Abbiamo dato una prima occhiata ad un addon che permette, con la stessa semplicità che Confluence mette a disposizione, di creare dei test o dei quiz da sottoporre al nostro pubblico. Qui si apre un ventaglio di possibili utilizzi che permette di poter utilizzare Confluence come il miglior strumento didattico web. Nei prossimi post andremo a riesaminare delle idee, già descritte in passato per la realizzazione di didattica, e cercheremo di calare questa nuova funzionalità, cosi come cercheremo, sempre nei prossimi post, di provarlo e di saggiarne le effettive potenzialità.

Reference

Maggiori informazioni sono reperibili qui.

Prova su strada

In questo post andremo ad eseguire la nostra solita prova dell’addon Pools per Confluence, cercando di identificare quali funzioni mette a disposizione e come possiamo sfruttare questi nuovi strumenti nel lavoro di tutti i giorni.

Installazione

Partiamo, come sempre, dalla installazione del nostro addon, cercando sempre di mostrarne tutti gli aspetti. Selezioniamo il nostro addon, come siamo abituati, dalla sezione dedicata agli addon 🙂

Selezionamo Free Trial per procedere con l’installazione della Trial …

…. accettiamo i termini di licenza ….

… e procediamo con l’installazione …

… quindi forniamo le credenziali per avere la licenza trial e successivamente ….

… siamo pronti ad usare questo addon 🙂

Al termine della installazione, siamo subito reindirizzati alla nuova pagina del profilo, dedicato proprio ai polls.

Configurazione

Lato configurazione, non abbiamo alcuna particolare schermata da citare e alcuna indicazione. Possiamo quindi partire con la sessione di test

Test, test, test, test, test, test ed ancora test

Per creare il nostro primo poll, andiamo a selezionare in lato a destra, dove abbiamo i due tasti, come mostrato in figura:

attiviamo le autocomposizioni per la generazione dei possibili tipi di poll. Se selezioniamo Make Choice, veniamo indirizzati nella agevole autocomposizione, come mostrato nella figura sottostante:

da dove andiamo a definire il nostro primo poll. Inseriamo ovviamente dei valori di esempio, ottenendo quanto segue:

che possiamo subito usare per andare a votare, come mostrato nella figura successiva,

che ci mostra subito il risultato della nostra votazione e ci permette di poter eseguire rollback della risposta data.

Se vogliamo proporre il Poll?

Abbiamo visto la creazione del Poll. Vediamo adesso come condividerlo con gli altri utenti. La prima cosa che notiamo è che sono messe a disposizioni opportune macro attraverso le quali andiamo a inserire il poll sulle nostre pagine confluence. La autocomposizione ci consente di scegliere tra i poll disponibili e di visualizzarlo in anteprima, come mostrato in figura:

La visualizzazione non presenta caratteristiche particolari, come mostrato di seguito:

ed il risultato è notevole.

In aggiunta, se noi abbiamo creato il poll, abbiamo la possibilità di ricevere le notifiche dell’avvenuta votazione direttamente dal sistema di messaggistica di Confluence. Attraverso un utente di test ho eseguito una nuova votazione e, come mostrato dalla figura successiva:

notiamo che ci viene notificato e questo è il risultato:

dove ci viene comunicato che l’utente demo, un nome di eccelsa fantasia :-P, ha eseguito la votazione.

Conclusione

Abbiamo eseguito un test su di un addon interessante che può essere utilizzato in tantissimi contesti.

Una piccola curiosità

Riporto una piccola curiosità, che ritengo molto importante. Quando ho eseguito il primo test, ho notato che l’addon non funzionava correttamente e non riusciva a salvare la votazione. Ho subito contattato il supporto del produttore dell’addon. Ci terrei a segnalare che la risposta è stata fornita in giornata, segnalandomi che il problema era causato da MySQL 5.7 (al momento in cui viene redatto il post, non risulta ancora totalmente supportato da Atlassian), ma che era comunque riuscito a risolverlo, rilasciano una nuova versione dell’addon.

Post aggiornamento, come potete vedere dal post, l’addon rispondeva correttamente in ogni sua parte.

Mi permetto di complimentarmi per la rapidità e la professionalità dimostrata. 🙂

Reference

Maggiori informazioni sull’addon sono reperibili qui.

Valutiamo alternative

In questo post andremo ad eseguire una valutazione della macro Roadmap di Confluence, andando ad esaminare che cosa viene offerto come …. alternativa.

Andiamo subito al sodo

Partiamo subito dando la prima carrellata di addons che sono presenti sul Marketplace della Atlassian, cercando subito di carpirne i dettagli.

Il primo addon è Aha! Visual Product Roadmaps, per Confluence Cloud. Si tratta di un addon gratuito (al momento in cui viene redatto il post) che permette di poter generare delle roadmap e dei grafici molto interessanti.

Andando ad esaminare il tutto, notiamo che:

• Possiamo creare delle roadmap che nulla hanno ad invidiare a quelle che sono messe a disposizione della macro standard 
• Possiamo pubblicare il tutto in maniera molto agevole 
• Permette di poter impostare un piano 
• Mette a disposizione una reportistica molto completa 

Proseguiamo la nostra carrellata con il seguente addon: Wizeline Portfolio Planning and Roadmaps per JIRA, disponibile per cloud e gratuito (al momento in cui viene scritto il post), che permette di poter realizzare delle roadmap direttamente su JIRA. Andando a curiosare sulle varie funzionalità abbiamo che:

• Permette di tracciare agevolmente i progress di un progetto 
• Permette di tracciare i progressi del team di lavoro 

Concludiamo questa panoramica con Sketchboard.Me for Confluence, disponibile solo per Server, permette di realizzare roadmap e tante altre cose molto interessanti. Vediamole nel dettaglio:

• Diagrammi UML per tutti i gusti 
• Permette di creare degli Use Case Diagram 
• Permette di creare degli activity diagrams 

Conclusioni

Abbiamo fatto una breve carrellata di quali possibili alterative possiamo avere alla singola macro Roadmap. Approfitto anche per una semplice considerazione: Questo è quanto esaminato fino ad oggi, ma consiglio sempre una visita mensile al Marketplace in modo da controllare sempre le ultime novità dalla Galassia Atlassian 😀

Oltre al roadmap standard, non ne conosco. L’argomento è interessante. Posso suggerirti idi esaminare questi: Cloud: https://marketplace.atlassian.com/plugins/io.aha.connect/cloud/overview# Server + Cloud https://marketplace.atlassian.com/plugins/com.wizeline.jira-connector/server/overview Server: https://marketplace.atlassian.com/plugins/net.sevenscales.confluence.plugins.sketcho-confluence/server/overview Entro qualche mese dovrei risucire a provarli e pubblico una recensione. FABIO

Una interessante notizia

In questo post andiamo ad esaminare una notizia che è stata … captata dall’artigiano. Cerchiamo di scoprirne di più.

Andiamo al sodo

La //SEIBERT/MEDIA ha comunicato che il suo addon Draw.io, ovvero l’addon per JIRA che consente di poter creare dei grafici da poter riportare all’interno di JIRA, è adesso gratuito. La comunicazione presente nel blog aziendale della stessa //SEIBERT/MEDIA, come potete vedere di seguito:

http://blog.draw.io/draw-io-for-jira-is-now-free/

Avevamo già censito la controparte per Confluence in questo post, dove evidenziavamo le potenzialità dell’addon, ed in questo post, dove mostravamo che cosa offriva.

Conclusioni

Si questo è molto interessante. SI offre la possibilità di inserire dei grafici anche su JIRA. Questo sarà oggetto di una ulteriore prova nei prossimi post.

Per i fans di Atlassian

In questo post andremo ad introdurre una nuova community dei Fans di Atlassian.

In principio era Linkedin Group….

In principio esisteva il gruppo linkedin  Atlassian Fans. Il 6 giugno il gruppo è stato sostituito con una nuova community al fine di ottimizzare le interazioni ed offrire anche una serie di … gustose opzioni.

Permette infatti di poter accedere ad alcune Challenge, dove è possibile confrontarsi e dove sperimentare le proprie conoscenze sui vari prodotti della Atlassian…

Ma non è tutto

Permette anche di essere aggiornati sulle ultime news e sulle ultime novità dal mondo Atlassian. Una finestra da cui andare a sbirciare sulle varie notizie 🙂

Ma è anche possibile giocare e svagarsi anche con piacevoli aneddoti o semplicemente avviare delle discussioni con altri utenti ed entusiasti.

Conclusione

Che altro dire. Potete iscrivervi e partecipare. Tutte le informazioni sono presenti su https://atlassian.influitive.com/users/sign_up . Buon divertimento 😀

Form per Confluence

In questo post andiamo a riprendere un argomento già trattato in passato: Come inserire delle Form in Confluence. Cercheremo di riprendere il filo del discorso e di capire che cosa è possibile fare adesso dopo quasi 2 anni da quando abbiamo iniziato a trattare l’argomento.

Form for Confluence by Adaptavist

Iniziamo a guardare che cosa offre questo addon della Adaptavist. Si tratta di una soluzione che molti utilizzatori di Confluence aspettano.

Form nelle pagine Confluence

Abbiamo la possibilità di inserire delle form direttamente nelle pagine di Confluence, consentendo agli utenti di poter inserire le informazioni senza saltare su altre applicazioni, e salvando direttamente le informazioni proprio sul database di Confluence.

Come mostrato dalla precedente istruzione, le informazioni sono disponibili direttamente dalla sezione di amministrazione di Confluence. Possiamo analizzarle, visualizzarle ed esportarle, per poi meglio analizzarle.

Abbiamo la possibilità di poter inviare le risposte via email, configurando in maniera abbastanza semplice il tutto.

viene anche permesso di visualizzare facilmente chi utilizza le form che inviano le informazioni via email.

Che utilizzi ci vengono in mente?

Esaminando questo addon, i primi utilizzi che ci vengono in mente sono i seguenti:

• Segnalazioni di issue/suggerimenti su pagine pubbliche di Confluence
• Sondaggi/brevi survey dove il risultato viene inviato via email
• Gestione di richieste ad uso interno, per le aziende che non utilizzano JIRA, ma solo Confluence
• (lasciamo che la fantasia ci guidi 😉 )

Conclusioni

Abbiamo visto un addon molto interessante, che potrebbe essere una soluzione ad alcuni problemi o che potrebbe tranquillamente aiutarci e supportarci nel lavoro di tutti i giorni. Nei prossimi post andremo a collaudarlo.

Reference

Maggiori informazioni sull’addon sono reperibili:

• Atlassian marketplace
• Sito Adaptavist.