{"id":25768330,"url":"https://github.com/jhudsl/documentation_and_usability","last_synced_at":"2026-05-15T09:15:48.406Z","repository":{"id":42523401,"uuid":"355996860","full_name":"jhudsl/Documentation_and_Usability","owner":"jhudsl","description":"This course covers the basics of creating documentation and tutorials to maximize the usability of informatics tools. It is meant for individuals developing tools for informatics.","archived":false,"fork":false,"pushed_at":"2025-01-10T18:59:55.000Z","size":69495,"stargazers_count":1,"open_issues_count":8,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-10T19:44:08.437Z","etag":null,"topics":["audience-software-developers","category-software-dev","documentation","itn-course","software-development","usability","user-feedback","user-friendly"],"latest_commit_sha":null,"homepage":"https://jhudatascience.org/Documentation_and_Usability/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jhudsl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-08T17:33:44.000Z","updated_at":"2024-12-18T15:58:04.000Z","dependencies_parsed_at":"2024-06-26T19:56:24.954Z","dependency_job_id":"ce79ade1-13e7-4a52-988f-d8b403f6759f","html_url":"https://github.com/jhudsl/Documentation_and_Usability","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":"jhudsl/OTTR_Template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhudsl%2FDocumentation_and_Usability","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhudsl%2FDocumentation_and_Usability/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhudsl%2FDocumentation_and_Usability/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhudsl%2FDocumentation_and_Usability/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jhudsl","download_url":"https://codeload.github.com/jhudsl/Documentation_and_Usability/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240959074,"owners_count":19884910,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audience-software-developers","category-software-dev","documentation","itn-course","software-development","usability","user-feedback","user-friendly"],"created_at":"2025-02-27T00:51:30.817Z","updated_at":"2026-05-15T09:15:48.315Z","avatar_url":"https://github.com/jhudsl.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Documentation and Usability Course\n\nThis is a bookdown based course to cover the basics of creating documentation and tutorials to maximize the usability of ITCR tools.\n\nThis course is a part of an [ITCR training series](https://www.itcrtraining.org/) and was in part created from [this github template](https://github.com/jhudsl/OTTR_Template).\n\nYou can see the [rendered course material here](https://jhudatascience.org/Documentation_and_Usability/introduction.html) or [on Leanpub here](https://leanpub.com/universities/courses/jhu/documentation_and_usability) or [on Coursera here](https://www.coursera.org/learn/documentation-usability-cancer-informatics).\n\nThis course guides you on how to make a nice documentation website using [this handy template](https://github.com/jhudsl/template-documentation) and its associated checklists!\n\nHere's a preview of what that looks like\n![](resources/images/template-preview.png)\n\nIf you would like to contribute to this course material, take a look at the [CONTRIBUTING.md](./CONTRIBUTING.md) to get started and/or contact us on the [ITCR training website](https://www.itcrtraining.org/join-us).\n\n## About this course\n\nInformatics tools are designed to be used by a broad audience, everyone from entry level graduate students in biology to working professionals. Designing good user experiences can help increase usability of tools, but even for tools with necessarily complicated user interfaces, good documentation and tutorials can have an outsized impact on use and usability. This course is designed to teach principles of documentation and tutorials to tool developers in the ITCR and beyond.\n\n## Learning Objectives\n\nThis course will demonstrate how to:\n\n- Understand why usability and documentation is vital.\n- Identify your user community.\n- Build documentation and tutorials to maximize the usability of developed tools.\n- Obtain feedback from your users.\n\n## Encountering problems?\n\nIf you are encountering any problems with this course, please file a GitHub issue or fill out [this feedback form](https://forms.gle/bQHH3jPjMUj3gmcN7).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhudsl%2Fdocumentation_and_usability","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjhudsl%2Fdocumentation_and_usability","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhudsl%2Fdocumentation_and_usability/lists"}