Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Morphing the dev guide into teaching materials for 3 classes #32

Open
pbchase opened this issue Mar 9, 2020 · 1 comment
Open

Morphing the dev guide into teaching materials for 3 classes #32

pbchase opened this issue Mar 9, 2020 · 1 comment

Comments

@pbchase
Copy link
Contributor

pbchase commented Mar 9, 2020

RC EM Dev 101 – A hands-on class all about installing and using the development tools. The audience would be REDCap Admins, Project Builders who can get access to a redcap.zip, and aspiring developers. I assert every developer we have in the community is a REDCap admin who wanted to make REDCap do more. We should enable these people. An experienced developer would only need to read the class notes, but a REDCap admin who wants to level up probably needs some help. This about 60 - 90 minutes of content.

The content would be what's covered in https:/ctsit/redcap_external_module_development_guide/blob/master/docs/development_class.md with more explanation about how to use the dev tools Andy Martin provides in his docker environment. I would have exploratory exercises/demos targeted at the different audiences. We would discuss Control Center exploration (project builders and developers), external module installation and REDCap Repo exploration (everyone), deploying from github (everyone).

RC EM Dev 201 – A hands-off class discussing development concepts in REDCap modules. It would take some content from https://ctsit.github.io/redcap_external_module_development_guide/guide_for_admins_and_devs, but mostly add new content not yet written. The audience would be developers and aspirational developers. The content would be something like this:

  • Open, collaborative development
    • Funding sources require sharing and collaboration
    • Sharing and collaboration require good tools and practices
    • Repo hosting in github
  • Finding module code in GitHub
  • Official dev docs: in REDCap and in GitHub
  • Architectural concerns:
    • Enabling the consumer
    • Plugins
    • Hooks
    • REDCap Variables
    • Configuration management
    • Reading data: REDCap class vs SQL
    • Writing data: REDCap classes vs SQL
    • Logging activity: redcap_log_event, em log class, redcap_entity
    • Persisting data in the DB: em log class, redcap_entity, em config class, redcap_log_event

This about 60 minutes of content.

RC EM Dev 301 – A hands-on class with nothing but development exercises. The audience is developers and aspirational developers. Prereq is 201 class and a working toolset like that described in the 101 class. The content would be a refined version of https:/ctsit/redcap_external_module_development_guide/blob/master/docs/guide_for_devs.md, but with a better intro. This about 90 - 120 minutes of content.

The 101 and 301 classes would be capped at 15 students each because of their hands-on nature. 201 would be uncapped, but targeted at group of 30. I can see where I would get students that wanted 101 and 201 or 201 and 301. I doubt anyone who needed 101 could handle 301. Most people who can handle 301 would be bored by 101—they could set up the software themselves before they arrived. I think hands-on training like that proposed in 101 and 301 requires an assistant except in the smallest classes.

@pbchase
Copy link
Contributor Author

pbchase commented Sep 22, 2020

emd101.md and emd102.md added in Release 1.3.0. https:/ctsit/redcap_external_module_development_guide/blob/master/docs/development_class.md is deprecated and unlinked, but not yet deleted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant