genQual_v1.RmdThis vignette shows an example CoMMa specification for general qualitative studies. It can be initialized as follows:
initialized_genQual_v1 <-
comma::matrixMap_load(
"genQual_v1"
);The CoMMa specification’s metadata is:
| field | content |
|---|---|
| title | CoMMa specification for general qualitative studies |
| author | Gjalt-Jorn Peters and Tugce Varol |
| date | 2025-08-04 |
| comments | This CoMMa specification was included in the CoMMa introductory paper. |
| version | 1.0 |
| comma_version | 1.0 |
The specific contributor table for this CoMMa specification is:
| Contributor | Establishing the project group | Reviewing the literature | Conceptualization | Designing research methodology | Developing interview guide | Providing feedback on interview guide | Designing data management plan | Preparing participant communication | Designing analysis plan | Completing preregistration form | Securing ethical approval | Recruiting participants | Interviewing participants | Managing transcription of recordings | First codebook draft | Codebook feedback | Codebook finalization | Coding the data | Validation of the coding | Analyzing the data | Visualizing the data | Setting up software infrastructure | Implementing data management plan | Preparing and using analysis tools | Project coordination | Providing project supervision | Write the first draft | Provide feedback | Revising the manuscript | Submitting the preprint | Submitting the manuscript | Disseminating the findings with audience |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Example name 1 | ||||||||||||||||||||||||||||||||
| Example name 2 | ||||||||||||||||||||||||||||||||
When running the above command locally, when on Windows, you can export that matrix to your Downloads directory by copying that code fragment and then uncommenting the commented out line.
This matrix maps contributions as follows (from specific to generic):
comma::show_contribution_mapping(
initialized_genQual_v1,
output = "markdown"
);Establishing the project group: Identifying and organizing the research team and defining roles of each contributor [project_group]
– MAPS ONTO –>
Project administration: Management and coordination responsibility for the research activity planning and execution. [project_administration]
Reviewing the literature: Conducting a literature review to synthesize existing studies to inform the research [literature_review]
– MAPS ONTO –>
Conceptualization: Ideas; formulation or evolution of overarching research goals and aims. [conceptualization]
Conceptualization: Brainstorming, developing the research aim(s), question(s) and/or hypotheses, and adjusting these to pragmatic considerations to ensure their feasibility [goals]
– MAPS ONTO –>
Conceptualization: Ideas; formulation or evolution of overarching research goals and aims. [conceptualization]
Completing preregistration form: Preparing and submitting the project’s preregistration form [document_preparation]
– MAPS ONTO –>
Resources: Provision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools. [resources]
Securing ethical approval: Preparing, submitting documents and revising them if needed to obtain ethics committee approval [ethical_approval]
– MAPS ONTO –>
Project administration: Management and coordination responsibility for the research activity planning and execution. [project_administration]
Developing interview guide: Creating the questions and format for data collection [interview_guide]
– MAPS ONTO –>
Methodology: Development or design of methodology; creation of models [methodology]
Providing feedback on interview guide: Reviewing and suggesting improvements to data collection items [interview_guide_feedback]
– MAPS ONTO –>
Methodology: Development or design of methodology; creation of models [methodology]
Preparing participant communication: Based on the sampling strategies, designing the recruitment plan, drafting and organizing consent forms, recruitment emails, and other recruitment materials [recruitment_plan]
– MAPS ONTO –>
Methodology: Development or design of methodology; creation of models [methodology]
Designing analysis plan: Devising the analysis plans: which analyses will be conducted to achieve the research goals [analysis_plan]
– MAPS ONTO –>
Formal Analysis: Application of statistical, mathematical, computational, or other formal techniques to analyse or synthesize study data. [formal_analysis]
Designing research methodology: Outlining the study design, including methods of data collection and sampling strategies [research_design]
– MAPS ONTO –>
Methodology: Development or design of methodology; creation of models [methodology]
Recruiting participants: Inviting participants to the study and managing the recruitment process [recruitment]
– MAPS ONTO –>
Investigation: Conducting a research and investigation process, specifically performing the experiments, or data/evidence collection. [investigation]
Interviewing participants: Conducting online or on-site interviews with participants [data_collection]
– MAPS ONTO –>
Investigation: Conducting a research and investigation process, specifically performing the experiments, or data/evidence collection. [investigation]
Managing transcription of recordings: Storing audio/video recordings, transcribing them verbatim, and anonymizing the data collected during interviews [data_preparation]
– MAPS ONTO –>
Data curation: Management activities to annotate (produce metadata), scrub data and maintain research data (including software code, where it is necessary for interpreting the data itself) for initial use and later re-use. [data_curation]
First codebook draft: Producing the first draft of the codes, their descriptions, and coding instructions [initial_codebook_drafting]
– MAPS ONTO –>
Resources: Provision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools. [resources]
Codebook feedback: Providing feedback on the initial codebook [initial_codebook_feedback]
– MAPS ONTO –>
Resources: Provision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools. [resources]
Codebook finalization: Producing the final specification of the initial codebook [initial_codebook_finalization]
– MAPS ONTO –>
Resources: Provision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools. [resources]
Coding the data: Assigning the codes to the data [coding]
– MAPS ONTO –>
Formal Analysis: Application of statistical, mathematical, computational, or other formal techniques to analyse or synthesize study data. [formal_analysis]
Validation of the coding: Facilitate reconciliation of discrepancies in coding [coding_validation]
– MAPS ONTO –>
Formal Analysis: Application of statistical, mathematical, computational, or other formal techniques to analyse or synthesize study data. [formal_analysis]
Analyzing the data: Interpreting and synthesizing data using the selected analysis approach [analysis]
– MAPS ONTO –>
Formal Analysis: Application of statistical, mathematical, computational, or other formal techniques to analyse or synthesize study data. [formal_analysis]
Visualizing the data: Creating graphs, visual maps or other formats to communicate data and findings [visualization]
– MAPS ONTO –>
Visualization: Preparation, creation and/or presentation of the published work, specifically visualization/data presentation. [visualization]
Setting up software infrastructure: Selecting and organizing tools or platforms for storing software and code [software_storage]
– MAPS ONTO –>
Software: Programming, software development; designing computer programs; implementation of the computer code and supporting algorithms; testing of existing code components. [software]
Designing data management plan: Planning how to securely store and access data, determine its level of accessibility (e.g., open or restricted), and ensure proper anonymization throughout the project lifecycle [data_management_plan]
– MAPS ONTO –>
Data curation: Management activities to annotate (produce metadata), scrub data and maintain research data (including software code, where it is necessary for interpreting the data itself) for initial use and later re-use. [data_curation]
Implementing data management plan: Managing the data storage and access according to the plan [data_management]
– MAPS ONTO –>
Data curation: Management activities to annotate (produce metadata), scrub data and maintain research data (including software code, where it is necessary for interpreting the data itself) for initial use and later re-use. [data_curation]
Preparing and using analysis tools: Setting up and using software or tools required for data analysis [analysis_tool]
– MAPS ONTO –>
Software: Programming, software development; designing computer programs; implementation of the computer code and supporting algorithms; testing of existing code components. [software]
Project coordination: Tasks related to project coordination such as scheduling meetings, and tracking progress [coordination]
– MAPS ONTO –>
Project administration: Management and coordination responsibility for the research activity planning and execution. [project_administration]
Providing project supervision: Offering mentorship and ensuring project is executed according to the plans and scientific and ethical standards are met [supervision]
– MAPS ONTO –>
Supervision: Oversight and leadership responsibility for the research activity planning and execution, including mentorship external to the core team. [supervision]
Write the first draft: Producing the first version of the manuscript [writing]
– MAPS ONTO –>
Writing – original draft: Preparation, creation and/or presentation of the published work, specifically writing the initial draft (including substantive translation). [writing_original_draft]
Provide feedback: Reviewing the manuscript and providing feedback [feedback]
– MAPS ONTO –>
Writing – review & editing: Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre- or post-publication stages. [writing_review_editing]
Revising the manuscript: Incorporating feedback and editing the draft manuscript [feedback_revision]
– MAPS ONTO –>
Writing – review & editing: Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre- or post-publication stages. [writing_review_editing]
Submitting the preprint: Preparing and uploading a version of the manuscript to a preprint server [preprint]
– MAPS ONTO –>
Writing – review & editing: Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre- or post-publication stages. [writing_review_editing]
Submitting the manuscript: Finalizing and submitting the manuscript to a journal [submission]
– MAPS ONTO –>
Writing – review & editing: Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre- or post-publication stages. [writing_review_editing]
Disseminating the findings with audience: Sharing research findings with relevant audiences through such as social media, presentations and reports [dissemination]
– MAPS ONTO –>
Writing – review & editing: Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre- or post-publication stages. [writing_review_editing]