Diretrizes do Projeto de Página de Dispositivos Médicos

Medinor.org é um servidor que configuramos para ajudar a organizar um grande cache de arquivos da comunidade biomédica. Ele contém muitos manuais de reparo de dispositivos médicos de todos os tipos, que queremos — mas também muitas outras coisas que não queremos. Além disso, está muito desorganizado. Embora tudo o que está nele tenha sido amplamente compartilhado publicamente, trate-o como sensível enquanto classificamos e excluímos arquivos não essenciais.

Sua tarefa é renomear e organizar esses arquivos nas categorias e pastas apropriadas. Mais instruções podem ser encontradas abaixo.

Envie um e-mail para biomed@ifixit.com para nos informar que você tem interesse em participar desta tarefa monumental. Inclua seu nome, endereço de e-mail, localização (fuso horário) e um breve resumo sobre o que você faz e por que tem interesse em ser voluntário. Criaremos uma conta para você acessar o Medinor.org e enviaremos um e-mail com suas credenciais de login. Não se preocupe se você ainda não recebeu suas credenciais de login. Não queremos muitas pessoas usando o site ao mesmo tempo, então aguarde e você receberá suas credenciais eventualmente.

Por algum motivo, abrir e ler arquivos PDF é muito mais rápido no FireFox do que no Google Chrome. Se você só puder usar o Google Chrome, tudo bem; saiba apenas que, em alguns casos, você precisará baixar o PDF do Medinor.org para visualizar o documento inteiro. Você pode baixar a versão mais recente do FireFox aqui.

Você trabalhará principalmente em duas pastas no Medinor.org: PDFs e Medical Devices. Recomendamos usar pelo menos três abas/janelas separadas para este projeto.

1. Uma aba/janela é usada para a planilha.
2. Uma aba/janela é usada para mostrar a pasta “PDFs” no Medinor.org.
3. Uma aba/janela é usada para mostrar a pasta “Medical Devices” no Medinor.org.

Orientação: Dentro da pasta raiz “My Files” no medinor.org, você encontrará:

• All Literature — contém o cache original de arquivos. Você pode ignorar esta pasta.
• PDFs — esta é nossa “caixa de entrada”, contendo arquivos a serem classificados. Contém tudo o que obtivemos do All Literature após remover arquivos que não são PDF e arquivos com menos de 20 KB. O objetivo do projeto é identificar tudo aqui que queremos manter, organizar e mover para...
• Medical Device — esta é a “caixa de saída” para os PDFs que estamos mantendo, ou seja, nosso produto final. As pastas aqui precisam ser nomeadas e organizadas corretamente para espelhar a estrutura de conteúdo em ifixit.com/Device/Medical_Device — quando tudo estiver pronto, executaremos um script para importar automaticamente tudo o que estiver dentro para a iFixit e criar páginas de dispositivo/categoria apropriadas ao longo do caminho.
• Archive, Backup, Future Work, etc. — Você pode ignorar estas pastas com segurança.

Atribua a si mesmo uma pasta (ou conjunto de pastas) da planilha de ‘Folder Assignments’. Insira seu nome na coluna 'Reserved By' para que todos fiquem na mesma página. (Lembre-se: as pastas nesta lista estão localizadas dentro do diretório principal “PDFs”.)

Assim que terminar uma pasta conforme descrito abaixo, marque-a como ‘Complete!’ na Coluna D da planilha. Se você começou uma seção e não consegue continuar, marque a pasta como ‘Started but didn’t finish’ e deixe uma nota de onde você parou na Coluna E.

Em cada pasta e subpasta atribuída, veja qual conteúdo existe e decida se deseja manter ou excluir cada arquivo.

• Manuais de serviço são de alta prioridade, assim como os Manuais do proprietário/operador. Mantenha-os!
• Listas de peças — dê uma olhada e decida se parece útil, mas EXCLUA se vir preços ou listas de preços. Esses preços estão (muito provavelmente) desatualizados e são específicos do cliente. Manuais de serviço geralmente incluem uma lista de peças, então essas listas costumam ser redundantes.
• Arquivos irrelevantes. Exclua qualquer coisa específica de um hospital, logística ou outros arquivos que não sejam amplamente úteis para o reparo de máquinas.
• Outros/casos excepcionais: Faça o melhor para terminar suas categorias atribuídas, mas se você estiver totalmente travado em um arquivo difícil, marque-o como “NEEDS REVIEW” e faça uma nota na planilha de Medinor Curation.

Renomeie esses arquivos para que cada um seja facilmente legível/identificável por humanos. Inclua o nome do fabricante, o nome do modelo e o tipo de manual que o PDF cobre, tudo no título do documento. (Não se preocupe em preservar informações do nome de arquivo original.)

• Exemplo: Welch Allyn 300 Series Service Manual.pdf

Para mais detalhes sobre como nomear corretamente os dispositivos médicos e os documentos, visite a página Nomenclatura de Dispositivos.

Se um documento contiver mais de um idioma: Se contiver inglês, você não precisa fazer mais nada — terminou! Mas se ele não contiver inglês, adicione um sufixo com o código de idioma de duas letras (ou o principal). (Visite este site para obter mais informações sobre os códigos de idioma ISO de duas letras.)

• Exemplo de nome para arquivo contendo apenas inglês ou vários idiomas, incluindo inglês: Welch Allyn 300 Series Service Manual.pdf (mesmo do exemplo anterior)
• Exemplo de nome para arquivo que inclui apenas alemão e nenhum inglês: Welch Allyn 300 Series Service Manual_DE.pdf

Após consultar a comunidade biomédica, decidimos organizar toda a documentação com base principalmente no ambiente em que é usada — Clínico, Laboratorial, etc. Você encontrará essas pastas já criadas. Dentro de cada uma delas, crie pastas adicionais para organizar seus arquivos conforme necessário:

1. Uma subpasta por tipo de dispositivo (por exemplo, Ventilator) (nota: singular).
2. Sub-subpastas para cada fabricante desse tipo de dispositivo (por exemplo, ACME Ventilator).
   • Nota: Inclua o tipo de dispositivo (isso é importante) e não escreva apenas ACME.
   • Sempre que possível, use o fabricante atual ou o logotipo do fabricante mais proeminente na máquina/dispositivo.
3. Sub-sub-subpastas para cada dispositivo específico (por exemplo, ACME Super Pro 9000).
   • Não há necessidade de incluir o tipo de dispositivo aqui. Mantenha o nome curto, mas INCLUA o fabricante.

Nota: cada pasta precisa ter um nome globalmente exclusivo. “Testing Fixture” não é exclusivo o suficiente, enquanto Drager 1840 Testing Fixture está correto.

Quando cada pasta que você atribuiu a si mesmo estiver vazia, exclua-a e marque-a como complete na planilha. Repita o processo!

Se você não tiver certeza se um arquivo é relevante, marque-o como “NEEDS REVIEW” e faça uma nota na planilha de Medinor Curation.

Duplicatas: Exclua uma delas. Se você vir duas revisões do mesmo manual, mantenha apenas a versão mais recente e exclua as antigas.

Embora as alterações feitas pelos seus colegas estejam sincronizando em segundo plano, elas só são exibidas quando você atualiza a página. (O botão de atualizar do navegador funciona melhor; o botão de atualizar na interface do usuário parece ter falhas.)

Não há desfazer, então trabalhe com cuidado. Temos um backup, mas preferiríamos não usá-lo.

Ao abrir/visualizar arquivos PDF: Às vezes você pode rolar e ver o arquivo, mas às vezes ele não exibe nada ou exibe apenas a primeira página. Nesse caso, baixe o arquivo para visualizá-lo. (Se você ainda não conseguir visualizá-lo no Reader mesmo após o download, é lixo. Exclua-o!)

Mova-se rapidamente e, na dúvida, exclua coisas desnecessárias. Não se sinta mal; este é um projeto enorme e precisamos ser rápidos. Não fique paralisado tentando tomar uma decisão. O objetivo é publicar um primeiro rascunho para o mundo. Se você estiver se sentindo desmotivado e achando que não está trabalhando em algo importante, marque como “NEEDS REVIEW” e siga em frente. Mantenha seu ritmo.

As máquinas mais importantes são ventiladores, máquinas de anestesia, respiradores, BiPAP, CPAP e outras máquinas de auxílio respiratório. Depois disso, queremos cobrir todos os equipamentos comumente usados em hospitais ao redor do mundo. O objetivo é ter um único recurso abrangente para engenheiros biomédicos e outros profissionais médicos.

Esta planilha contém uma lista de todas as pastas no Medinor. Vamos conferir cada uma e garantir que esteja correta para podermos publicar todas!

Primeiro, atribua a si mesmo uma pasta adicionando seu nome ao lado dela na planilha. Então, no Medinor, clique com o botão direito na pasta e rotule-a como Review In Progress.

Em seguida, verifique se (a) a pasta está nomeada corretamente, de acordo com todas as instruções acima, e (b) se quaisquer arquivos ou pastas adicionais dentro dela também estão nomeados e classificados corretamente.

Problemas comuns que talvez você precise corrigir incluem:

• Documentos PDF com nomes insuficientemente descritivos, como 030139381.pdf. Certifique-se de que um humano consiga saber o que é o arquivo apenas olhando para ele. Se necessário, abra o documento, veja do que se trata e renomeie-o adequadamente. Por exemplo: Maquet Servo-i Ventilator - Service Manual.pdf.
• Nomes de pastas não específicos, como uma pasta nomeada apenas com o nome do fabricante, sem incluir o tipo de dispositivo. Por exemplo, dentro da pasta Ventilator, uma subpasta nomeada apenas “Maquet” é insuficiente. Renomeie a subpasta para “Maquet Ventilator”.
• Nomes de pastas com outros problemas, como códigos de idioma ou nomes genéricos como “manuals”. Toda pasta deve ser nomeada com o tipo de dispositivo (“Ventilator”), fabricante + tipo de dispositivo (“Maquet Ventilator”) ou modelo de dispositivo específico (“Maquet Servo-i”). Modelos de dispositivos específicos não devem ter subpastas para coisas como “service bulletins” — mova esses arquivos para a pasta do dispositivo pai e exclua a pasta “service bulletins”.

Faça as alterações necessárias ou envie-nos um e-mail se tiver dúvidas.

• Se a pasta parecer ter muitos problemas e você precisar de ajuda para corrigi-la, rotule-a como NEEDS WORK (tanto no Medinor quanto na lista abaixo na coluna "Folder Status").

Finalmente, quando tudo estiver conferido, rotule a pasta como Reviewed. É isso! Atribua a si mesmo outra pasta e repita o processo.

Esta é a primeira fase do projeto, onde estamos fazendo a triagem dos documentos e reduzindo-os a uma lista gerenciável. O próximo passo será adicionar metadados, fotos, informações contextuais adicionais sobre cada dispositivo e identificar quais informações estão faltando.