Options for Sharing Resources
ISDS has provided multiple options for storing and sharing files and resources among community/group members.
Surveillance Knowledge Repository
The Surveillance Knowledge Repository (KR) is an online database for sharing resources that are relevant to the entire surveillance community across multiple disciplines (Syndromic Surveillance, One Health, etc.) and includes resources, i.e. articles, presentations, webinars, etc. that can be viewed individually to share knowledge on research, data analysis processes, best practices, and a variety of other areas of interest.
The Group Pages on healthsurveillance.org are virtual shared spaces for groups to collaborate on specific projects and to share specific group resources, like meeting recordings, meeting notes, and documents that are being developed by the groups. The following file types are allowed to be uploaded to healthsurveillance.org:
AZW, EPUB, MOBI, SCE, SCI and XCOS , 7z, avi, asc, bmp, css, csv, doc, docx, dot, eps, flv, gif, gzip, ics, jpeg, jpg, js, mdb, mov, mp3, mp4, mpeg, mpg, notebook, pdf, png, ppt, pptm, pptx, pps, ppsx, psd, pub, qt, rar, rss, rtf, swf, tif, tiff, txt, wav, wma, wmv, wpd, xls, xlsx, xml, xspf and zip
Unfortunately, our AMS service does not allow users to upload executable code due to security concerns. We recommend users save their code (.r, .sas, etc.) to the ISDS Code Sharing Library or save it as a .txt or .rtf file before uploading it onto their group page on healthsurveillance.org.
ISDS Code Sharing Library
The ISDS Code Sharing Library on GitHub is a library for the community to store and share code across various groups and projects. Only code files (i.e. .r, .sas, etc.) and their associated documentation files should be stored in the library and can be linked to from either the KR or the Group Pages on healthsurveillance.org.
Code files uploaded to the ISDS Code Sharing Library should meet the following requirements:
- The code is complete (or it is being worked on but plans are to complete it eventually) – this prevents incomplete (less useful) files from cluttering the library.
- It is either code or complements a code script – because GitHub is for code collaboration ONLY. You can visit the Group pages on healthsurveillance.org for additional group specific resources.
- It accomplishes a task that others need to do often and would be interested in replicating– this shouldn’t be a place where people store their scripts that are useful to themselves only or just one health department. Those scripts should be stored on a personal GitHub account page and only moved to the ISDS GitHub Organizational page if requested by the Repository Owners.
- The person uploading the file understands it fully – this prevents people from uploading files that they may think are useful but probably aren’t.
- The code should be fairly well commented – so that other people have a chance or an easier time understanding what the code is doing at different points.
To upload code to the ISDS Code Sharing Library, you must have a GitHub account, which you can create free of charge here.