Linee guida per il progetto della pagina dei dispositivi medici

Medinor.org è un server che abbiamo configurato per aiutare a organizzare una vasta cache di file provenienti dalla comunità biomedica. Contiene tonnellate di manuali di riparazione per dispositivi medici di ogni tipo, che vogliamo, ma anche molta altra roba che non ci serve. Inoltre, è molto disorganizzato. Anche se tutto ciò che contiene è stato ampiamente condiviso pubblicamente, per favore, trattalo come materiale sensibile mentre selezioniamo ed eliminiamo i file non essenziali.

Il tuo compito è rinominare e organizzare questi file nelle categorie e cartelle appropriate. Ulteriori istruzioni sono disponibili qui sotto.

Invia un’email a biomed@ifixit.com per farci sapere che sei interessato a partecipare a questo compito monumentale. Includi il tuo nome, indirizzo email, posizione (fuso orario) e una breve descrizione di cosa fai e perché sei interessato a fare volontariato. Configureremo un account per te per accedere a Medinor.org e ti invieremo un’email con le tue credenziali di accesso per Medinor.org. Non preoccuparti se non hai ancora ricevuto le tue credenziali di accesso. Non vogliamo che troppe persone usino il sito web tutte in una volta, quindi attendi pazientemente e riceverai le tue credenziali prima o poi.

Per qualche motivo, aprire e leggere i PDF è molto più veloce tramite FireFox rispetto a Google Chrome. Se riesci a usare solo Google Chrome, va bene; sappi solo che in alcuni casi dovrai scaricare il PDF da Medinor.org per visualizzare l'intero documento. Puoi scaricare l'ultima versione di FireFox qui.

Lavorerai principalmente in due cartelle su Medinor.org: PDFs e Medical Devices. Ti consigliamo di utilizzare almeno tre schede/finestre separate per questo progetto.

1. Una scheda/finestra viene usata per il foglio di calcolo.
2. Una scheda/finestra viene usata per mostrare la cartella “PDFs” su Medinor.org.
3. Una scheda/finestra viene usata per mostrare la cartella “Medical Devices” su Medinor.org.

Orientamento: All’interno della cartella principale “My Files” su medinor.org, troverai:

• All Literature—contiene la cache originale dei file. Puoi ignorarla.
• PDFs—questa è la nostra “posta in arrivo”, che contiene i file da smistare. Contiene tutto ciò che abbiamo ottenuto da All Literature dopo aver rimosso i file non PDF e i file <20 KB. L'obiettivo del progetto è identificare tutto ciò che vogliamo conservare qui, organizzarlo e spostarlo in...
• Medical Device—questa è la “posta in uscita” per i PDF che conserviamo, ovvero il nostro prodotto finale. Le cartelle qui devono essere rinominate e organizzate correttamente in modo che rispecchino la struttura dei contenuti su ifixit.com/Device/Medical_Device - una volta terminato tutto, eseguiremo uno script per importare automaticamente tutto ciò che è contenuto in iFixit e creare le pagine di dispositivo/categoria appropriate lungo il percorso.
• Archive, Backup, Future Work, etc.—Puoi ignorarle tranquillamente.

Assegnati una cartella (o un insieme di cartelle) dal foglio di calcolo ‘Folder Assignments’. Inserisci il tuo nome nella colonna ‘Reserved By’ in modo che tutti possano essere aggiornati. (Ricorda, le cartelle in questo elenco si trovano all'interno della directory principale “PDFs”.)

Una volta terminata una cartella come descritto di seguito, contrassegnala come ‘Complete!’ nella colonna D del foglio di calcolo. Se hai iniziato una sezione e non sei in grado di continuare, contrassegna quella cartella come ‘Started but didn’t finish’ e lascia una nota su dove ti sei interrotto nella colonna E.

In ogni cartella e sottocartella assegnata, controlla quali contenuti sono presenti e decidi se conservare o eliminare ciascun file.

• I manuali di assistenza sono ad alta priorità, così come i manuali per l’utente/operatore. Conservali!
• Elenchi parti - dai un'occhiata e decidi se sembra utile, ma ELIMINALO se vedi prezzi o listini prezzi. Quei prezzi sono (molto probabilmente) obsoleti e specifici per il cliente. I manuali di assistenza solitamente includono un elenco parti, quindi sono spesso ridondanti.
• File non rilevanti. Elimina tutto ciò che è specifico per un ospedale, logistica o altri file che non sono ampiamente utili per riparare le macchine.
• Altro/casi limite: Fai del tuo meglio per terminare le categorie assegnate, ma se sei completamente bloccato su un file difficile, contrassegnalo come “NEEDS REVIEW” e prendi nota nel foglio di calcolo Medinor Curation.

Rinomina questi file in modo che ognuno sia facilmente leggibile/identificabile dagli esseri umani. Includi il nome del produttore, il nome del modello e il tipo di manuale coperto dal PDF, tutto nel titolo del documento. (Non preoccuparti di preservare le informazioni nel nome file originale.)

• Esempio: Welch Allyn 300 Series Service Manual.pdf

Per maggiori dettagli su come rinominare correttamente i dispositivi medici e i documenti, visita la pagina Nomenclatura dispositivo.

Se un documento contiene più di una lingua: Se contiene l'inglese, non devi fare altro—hai finito! Ma se non contiene l'inglese, aggiungi un suffisso con il primo (o principale) codice lingua a due lettere. (Visita questo sito web per maggiori informazioni sui codici lingua ISO a due lettere.)

• Esempio di nome per file contenente solo inglese, o più lingue incluso l'inglese: Welch Allyn 300 Series Service Manual.pdf (uguale a sopra)
• Esempio di nome per file che include solo tedesco, e nessun inglese: Welch Allyn 300 Series Service Manual_DE.pdf

Dopo aver consultato la comunità biomedica, abbiamo deciso di organizzare tutta la documentazione basandoci principalmente sull'ambiente in cui viene utilizzata—Clinico, Laboratorio, ecc. Troverai queste cartelle già create. All'interno di ciascuna di esse, crea ulteriori cartelle per organizzare i tuoi file secondo necessità:

1. Una sottocartella per tipo di dispositivo (es. Ventilatore) (nota: singolare).
2. Sottosottocartelle per ogni produttore di quel tipo di dispositivo (es. ACME Ventilatore).
   • Nota: includi il tipo di dispositivo (è importante) e non limitarti a dire ACME.
   • Quando possibile, usa il produttore più attuale o il logo del produttore più prominente sulla macchina/dispositivo
3. Sottosottosottocartelle per ogni specifico dispositivo (es. ACME Super Pro 9000).
   • Non c'è bisogno di includere il tipo di dispositivo qui. Mantieni il nome breve, ma INCLUDI il produttore.

Nota: ogni cartella deve avere un nome univoco a livello globale. ‘Testing Fixture’ non è abbastanza univoco, mentre Drager 1840 Testing Fixture va bene.

Quando ogni cartella che ti sei assegnato è vuota, eliminala e contrassegnala come complete sul foglio di calcolo. Ripeti l'operazione!

Se non sei sicuro che un file sia rilevante, contrassegnalo come “NEEDS REVIEW” e prendi nota nel foglio di calcolo Medinor Curation.

Duplicati: Elimina uno di essi. Se vedi due revisioni dello stesso manuale, conserva solo la versione più recente ed elimina le altre.

Anche se le modifiche apportate dai tuoi compagni di squadra SI stanno sincronizzando in background, vengono visualizzate solo quando aggiorni la pagina. (Il pulsante di aggiornamento del browser funziona meglio; il pulsante di aggiornamento nell'interfaccia utente sembra avere problemi.)

Non c'è annulla, quindi lavora con attenzione. Abbiamo un backup, ma preferiremmo non usarlo.

Quando apri/visualizzi file PDF: A volte puoi scorrere e vedere il file, ma a volte non viene visualizzato o visualizza solo la prima pagina. In tal caso, scarica il file per visualizzarlo. (Se non riesci ancora a visualizzarlo nel Reader anche dopo il download, è spazzatura. Eliminalo!)

Muoviti velocemente e tendi a eliminare le cose non necessarie. Non sentirti in colpa, questo è un progetto enorme e dobbiamo muoverci rapidamente. Non restare paralizzato nel prendere una decisione. Si tratta di far uscire una prima bozza nel mondo. Se ti senti demoralizzato e pensi di non lavorare su qualcosa di importante, contrassegnalo come “NEEDS REVIEW” e vai avanti. Mantieni lo slancio.

Le macchine più importanti sono ventilatori, macchine per anestesia, respiratori, BiPAP, CPAP e altre macchine di assistenza respiratoria. Dopodiché, vogliamo coprire tutte le apparecchiature comunemente usate negli ospedali di tutto il mondo. L'obiettivo è avere un'unica risorsa completa per ingegneri biomedici e altri professionisti medici.

Questo foglio di calcolo contiene un elenco di tutte le cartelle su Medinor. Controlliamo due volte ciascuna di esse e assicuriamoci che sia corretta, così potremo pubblicarle tutte!

Per prima cosa, assegnati una cartella aggiungendo il tuo nome accanto ad essa sul foglio di calcolo. Poi, su Medinor, fai clic destro sulla cartella e etichettala come Review In Progress.

Successivamente, controlla che (a) la cartella sia nominata correttamente, in modo coerente con tutte le istruzioni sopra, e (b) che eventuali file o cartelle aggiuntivi all'interno siano anch'essi nominati e ordinati correttamente.

Problemi comuni che potresti dover correggere includono:

• Documenti PDF con nomi non sufficientemente descrittivi, come 030139381.pdf. Assicurati che un essere umano possa capire cos'è il file semplicemente guardandolo. Se necessario, apri il documento, vedi cos'è effettivamente e rinominalo in modo appropriato. Ad esempio: Maquet Servo-i Ventilator - Service Manual.pdf.
• Nomi di cartelle non specifici, come una cartella nominata solo dopo il produttore, senza includere il tipo di dispositivo. Ad esempio, all'interno della cartella Ventilatore, una sottocartella nominata semplicemente “Maquet” è insufficiente. Rinomina la sottocartella “Maquet Ventilatore.”
• Nomi di cartelle con altri problemi, come codici lingua o nomi non specifici come “manuals.” Ogni cartella dovrebbe essere nominata dopo un tipo di dispositivo (“Ventilatore”), produttore + tipo di dispositivo (“Maquet Ventilatore”) o modello di dispositivo specifico (“Maquet Servo-i”). I modelli di dispositivo specifici non dovrebbero avere sottocartelle per cose come “service bulletins”—sposta quei file nella cartella principale del dispositivo ed elimina la cartella “service bulletins”.

Apporta le modifiche necessarie, o inviaci un'email se hai domande.

• Se la cartella sembra avere troppi problemi e hai bisogno di aiuto per sistemarla, etichettala nuovamente come NEEDS WORK (sia su Medinor che nell'elenco sottostante nella colonna "Folder Status").

Infine, quando tutto è a posto, etichetta nuovamente la cartella come Reviewed. Ecco fatto! Assegnati un'altra cartella e ripeti l'operazione.

Questa è la prima fase del progetto, in cui stiamo selezionando i documenti e restringendo il campo a un elenco gestibile. Successivamente aggiungeremo metadati, foto, ulteriori informazioni contestuali su ciascun dispositivo e identificheremo quali informazioni mancano.