Linear

Collegare

Prema “Collega” accanto a Linear, sotto “Cloud”, nella home di Exporter. Acceda con Apple; il browser apre la pagina di Linear, dove preme “Authorize”. Exporter chiede a Linear solo di leggere. Tornato in Exporter, scelga dove vanno i file e prema “Usa questa cartella”.

Il token di Linear resta sigillato sul server di Exporter. Il suo Mac accede a quel server e non lo possiede mai.

Scegliere gli elementi

La pagina di scelta elenca ogni issue, progetto e documento, tutti selezionati, con tre schede: Issue, Progetti e Documenti. Deselezioni ciò che non vuole; il suo file resta fuori.

Dove vanno i file

Una cartella direttamente nella sua cartella Inizio, come ~/Documents, riceve una cartella linear-export; una più profonda si usa così com’è.

• Issue: una cartella per team, un file per issue, chiamato con il suo id e il suo titolo: Northwind/NW-142 Invite flow.md
• Progetti: Projects/Q4 launch.md
• Documenti: Documents/<project or team>/<title>.md

Il file

Il front matter di una issue riporta id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due e le date, con source_url che la apre in Linear. Poi il titolo, la descrizione e ogni commento, dal più vecchio. Un progetto riporta stato, responsabile, team e date; un documento il suo progetto, team e autore. Gli orari sono in UTC.

Sincronizzazione

Linear avvisa il server di Exporter di ogni modifica. Il server riscrive subito il file e lo dice al suo Mac, che lo scarica: una modifica arriva in pochi secondi, al massimo un minuto. Una issue rinominata sposta il suo file; una che archivia, butta o elimina lo perde. “Sincronizza ora” chiede prima al server; “Risincronizza tutto” riscrive ogni file.

Exporter Cloud

I primi 7 giorni dal primo collegamento sono gratis. Poi Exporter Cloud è un abbonamento nell’App Store: solo Linear, o All Cloud per ogni fonte cloud che aggiungiamo, al mese o all’anno. Quando un piano finisce, la sincronizzazione si ferma e i suoi file restano. Trenta giorni dopo il server elimina le sue copie e il token.

Account

Impostazioni › Account mostra l’indirizzo email con cui ha effettuato l’accesso. “Esci” conserva il collegamento per il prossimo accesso. “Elimina account…” scollega ogni spazio di lavoro ed elimina tutto ciò che il server conserva per lei. I file sul suo Mac restano.

Riga di comando

exporter export --source linear --dest <folder> scrive i file dello spazio di lavoro in una cartella autorizzata sulla scheda Riga di comando. Veda la riga di comando.

Problemi e soluzioni

• La scheda dice “Ricollega…”: Linear non accetta più il collegamento, spesso perché l’app è stata rimossa nelle impostazioni di Linear. Lo prema e autorizzi di nuovo.
• La scheda dice “Accedi…”: la sessione è terminata. Acceda con lo stesso account Apple e la sincronizzazione riprende.
• Manca una issue: controlli che sia selezionata, poi prema “Sincronizza ora”. Le issue archiviate non vengono esportate.