Skip to content

Commit d6a8a25

Browse files
author
Quarto GHA Workflow Runner
committed
Built site for gh-pages
1 parent 46c3e57 commit d6a8a25

4 files changed

Lines changed: 11 additions & 12 deletions

File tree

.nojekyll

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
54d97b06
1+
5e7c08a5

JRaviLab-docs.pdf

7 Bytes
Binary file not shown.

llm_use_guidelines.html

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -456,15 +456,15 @@ <h1 class="title">Appendix H — LLM use guidelines for research trainees</h1>
456456
<hr>
457457
<section id="core-principle" class="level2" data-number="H.1">
458458
<h2 data-number="H.1" class="anchored" data-anchor-id="core-principle"><span class="header-section-number">H.1</span> Core principle</h2>
459-
<p>Your primary goal in training is developing independent scientific thinking, not maximizing efficiency. LLMs are tools that should <strong>amplify your capabilities</strong>, not replace the intellectual work that builds expertise.</p>
459+
<p>Your primary goal in training is to develop independent scientific thinking, not to maximize efficiency. LLMs are tools that should <strong>amplify your capabilities</strong>, not replace the intellectual work that builds expertise.</p>
460460
<hr>
461461
</section>
462462
<section id="strategic-uses-enhance-learning" class="level2" data-number="H.2">
463463
<h2 data-number="H.2" class="anchored" data-anchor-id="strategic-uses-enhance-learning"><span class="header-section-number">H.2</span> ✓ Strategic uses (enhance learning)</h2>
464464
<section id="documentation-organization" class="level3" data-number="H.2.1">
465465
<h3 data-number="H.2.1" class="anchored" data-anchor-id="documentation-organization"><span class="header-section-number">H.2.1</span> Documentation &amp; organization</h3>
466466
<ul>
467-
<li>Clean up (not draft) READMEs, code comments, inline documentation</li>
467+
<li>Clean up (not draft) READMEs, code comments, and inline documentation</li>
468468
<li>Organize project directories and file structures</li>
469469
<li>Create documentation templates for GitHub repos, datasets</li>
470470
<li>Generate boilerplate code structure (after understanding fundamentals)</li>
@@ -483,7 +483,7 @@ <h3 data-number="H.2.2" class="anchored" data-anchor-id="learning-skill-developm
483483
<section id="critique-gap-analysis" class="level3" data-number="H.2.3">
484484
<h3 data-number="H.2.3" class="anchored" data-anchor-id="critique-gap-analysis"><span class="header-section-number">H.2.3</span> Critique &amp; gap analysis</h3>
485485
<ul>
486-
<li>Get feedback on drafts you’ve already written (after ≥2 revision rounds w/ colleagues)</li>
486+
<li>Get feedback on drafts you’ve already written (after ≥2 revision rounds with colleagues)</li>
487487
<li>Identify logical gaps, clarity issues, or missing considerations</li>
488488
<li>Check for completeness in project proposals or documentation</li>
489489
<li>Request alternative perspectives on your interpretations</li>
@@ -550,7 +550,7 @@ <h3 data-number="H.3.3" class="anchored" data-anchor-id="data-results"><span cla
550550
<section id="core-scientific-skills" class="level3" data-number="H.3.4">
551551
<h3 data-number="H.3.4" class="anchored" data-anchor-id="core-scientific-skills"><span class="header-section-number">H.3.4</span> Core scientific skills</h3>
552552
<ul>
553-
<li>❌ Bypassing reading original papers (especially in first 1-3 years)</li>
553+
<li>❌ Bypassing reading original papers (especially in the first 1-3 years)</li>
554554
<li>❌ Using AI instead of asking labmates/mentors for help</li>
555555
<li>❌ Generating hypotheses or research questions</li>
556556
<li>❌ Tasks where discussion with colleagues provides more learning value</li>
@@ -578,7 +578,7 @@ <h3 data-number="H.4.2" class="anchored" data-anchor-id="documentation"><span cl
578578
<li>Date of use</li>
579579
<li>Prompts used</li>
580580
<li>Output generated</li>
581-
<li>How you verified/modified it</li>
581+
<li>How you verified/modified the LLM output</li>
582582
<li>Errors found and corrected</li>
583583
</ul>
584584
</section>
@@ -657,7 +657,6 @@ <h2 data-number="H.7" class="anchored" data-anchor-id="remember"><span class="he
657657
<li><strong>Hallucinations are real:</strong> Always verify citations, facts, and technical claims</li>
658658
<li><strong>When in doubt, ask your PI first</strong></li>
659659
<li>Check LLM’s Settings → Privacy/Data controls` and turn off chat history, memory, personalization, and training‑related data usage for maximum privacy and no data retention.</li>
660-
<li></li>
661660
</ul>
662661
<blockquote class="blockquote">
663662
<p>The goal isn’t to avoid AI entirely — it’s to use it strategically so you emerge from training as an independent scientist with distinctive capabilities, not someone dependent on tools they can’t verify or correct. You will have ample opportunities as a PI or a scientist in an industry, to learn and use LLMs quickly and efficiently — there’s no need to rush into it now at the cost of your successful training.</p>

search.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -530,7 +530,7 @@
530530
"href": "llm_use_guidelines.html",
531531
"title": "Appendix H — LLM use guidelines for research trainees",
532532
"section": "",
533-
"text": "H.1 Core principle\nEnhancing learning without compromising training potential.\nA brief, meta compilation of LLM guidelines using an LLM!\nYour primary goal in training is developing independent scientific thinking, not maximizing efficiency. LLMs are tools that should amplify your capabilities, not replace the intellectual work that builds expertise.",
533+
"text": "H.1 Core principle\nEnhancing learning without compromising training potential.\nA brief, meta compilation of LLM guidelines using an LLM!\nYour primary goal in training is to develop independent scientific thinking, not to maximize efficiency. LLMs are tools that should amplify your capabilities, not replace the intellectual work that builds expertise.",
534534
"crumbs": [
535535
"Appendices",
536536
"<span class='chapter-number'>H</span>  <span class='chapter-title'>LLM use guidelines for research trainees</span>"
@@ -541,7 +541,7 @@
541541
"href": "llm_use_guidelines.html#strategic-uses-enhance-learning",
542542
"title": "Appendix H — LLM use guidelines for research trainees",
543543
"section": "H.2 ✓ Strategic uses (enhance learning)",
544-
"text": "H.2 ✓ Strategic uses (enhance learning)\n\nH.2.1 Documentation & organization\n\nClean up (not draft) READMEs, code comments, inline documentation\nOrganize project directories and file structures\nCreate documentation templates for GitHub repos, datasets\nGenerate boilerplate code structure (after understanding fundamentals)\n\n\n\nH.2.2 Learning & skill development\n\nAfter independent attempts: Get explanations of complex concepts\nGenerate analogies to understand difficult topics\nBrainstorm approaches to problems (but verify with literature/experts)\nUse tools like Perplexity to generate reading lists (always check for predatory journals, hallucinated citations)\nAsk “what topics do I need to know to understand this paper/method?”\n\n\n\nH.2.3 Critique & gap analysis\n\nGet feedback on drafts you’ve already written (after ≥2 revision rounds w/ colleagues)\nIdentify logical gaps, clarity issues, or missing considerations\nCheck for completeness in project proposals or documentation\nRequest alternative perspectives on your interpretations\n\n\n\nH.2.4 Code assistance (after mastery)\n\nDebug assistance when you’ve already diagnosed the problem area\nSyntax help for languages you already understand\nCode refactoring suggestions (when you understand the tradeoffs)\nStandard visualization templates (after learning plotting fundamentals)\n\n\n\nH.2.5 Communication practice\n\nVoice mode for talk practice: Deliver presentations, get feedback on flow, narrative, pacing, clarity\nPractice for comprehensive exams or conference talks\nGet suggestions for improving scientific communication style\nPolish grammar and style (like an advanced Grammarly)\n\n\n\nH.2.6 Literature search\n\nGenerate lists of related papers to explore (verify all exist)\nFind connections between research areas\nIdentify key terminology and concepts in new fields",
544+
"text": "H.2 ✓ Strategic uses (enhance learning)\n\nH.2.1 Documentation & organization\n\nClean up (not draft) READMEs, code comments, and inline documentation\nOrganize project directories and file structures\nCreate documentation templates for GitHub repos, datasets\nGenerate boilerplate code structure (after understanding fundamentals)\n\n\n\nH.2.2 Learning & skill development\n\nAfter independent attempts: Get explanations of complex concepts\nGenerate analogies to understand difficult topics\nBrainstorm approaches to problems (but verify with literature/experts)\nUse tools like Perplexity to generate reading lists (always check for predatory journals, hallucinated citations)\nAsk “what topics do I need to know to understand this paper/method?”\n\n\n\nH.2.3 Critique & gap analysis\n\nGet feedback on drafts you’ve already written (after ≥2 revision rounds with colleagues)\nIdentify logical gaps, clarity issues, or missing considerations\nCheck for completeness in project proposals or documentation\nRequest alternative perspectives on your interpretations\n\n\n\nH.2.4 Code assistance (after mastery)\n\nDebug assistance when you’ve already diagnosed the problem area\nSyntax help for languages you already understand\nCode refactoring suggestions (when you understand the tradeoffs)\nStandard visualization templates (after learning plotting fundamentals)\n\n\n\nH.2.5 Communication practice\n\nVoice mode for talk practice: Deliver presentations, get feedback on flow, narrative, pacing, clarity\nPractice for comprehensive exams or conference talks\nGet suggestions for improving scientific communication style\nPolish grammar and style (like an advanced Grammarly)\n\n\n\nH.2.6 Literature search\n\nGenerate lists of related papers to explore (verify all exist)\nFind connections between research areas\nIdentify key terminology and concepts in new fields",
545545
"crumbs": [
546546
"Appendices",
547547
"<span class='chapter-number'>H</span>  <span class='chapter-title'>LLM use guidelines for research trainees</span>"
@@ -552,7 +552,7 @@
552552
"href": "llm_use_guidelines.html#avoid-compromises-training",
553553
"title": "Appendix H — LLM use guidelines for research trainees",
554554
"section": "H.3 ✗ Avoid (compromises training)",
555-
"text": "H.3 ✗ Avoid (compromises training)\n\nH.3.1 Writing & thinking\n\n❌ Having LLMs write any first draft (manuscripts, proposals, abstracts, reports)\n❌ Generating content from bullet points without writing yourself\n❌ Summarizing your own results or data interpretations\n❌ Writing discussion/conclusion sections\n❌ Any writing task you’ve done &lt;10-20 times independently\n\n\n\nH.3.2 Code & analysis\n\n❌ Generating analysis code for methods you don’t understand\n❌ Writing entire scripts/pipelines without knowing each component\n❌ Using AI for statistical approaches you can’t verify\n❌ Debugging without first attempting to understand the error yourself\n❌ Any coding task you’ve done &lt;5-10 times independently\n\n\n\nH.3.3 Data & results\n\n❌ Uploading raw research data to public LLM systems\n❌ Having AI analyze, visualize, or interpret your experimental/computational data\n❌ Using AI for any task involving sensitive, unpublished, or controlled-access data\n\n\n\nH.3.4 Core scientific skills\n\n❌ Bypassing reading original papers (especially in first 1-3 years)\n❌ Using AI instead of asking labmates/mentors for help\n❌ Generating hypotheses or research questions\n❌ Tasks where discussion with colleagues provides more learning value",
555+
"text": "H.3 ✗ Avoid (compromises training)\n\nH.3.1 Writing & thinking\n\n❌ Having LLMs write any first draft (manuscripts, proposals, abstracts, reports)\n❌ Generating content from bullet points without writing yourself\n❌ Summarizing your own results or data interpretations\n❌ Writing discussion/conclusion sections\n❌ Any writing task you’ve done &lt;10-20 times independently\n\n\n\nH.3.2 Code & analysis\n\n❌ Generating analysis code for methods you don’t understand\n❌ Writing entire scripts/pipelines without knowing each component\n❌ Using AI for statistical approaches you can’t verify\n❌ Debugging without first attempting to understand the error yourself\n❌ Any coding task you’ve done &lt;5-10 times independently\n\n\n\nH.3.3 Data & results\n\n❌ Uploading raw research data to public LLM systems\n❌ Having AI analyze, visualize, or interpret your experimental/computational data\n❌ Using AI for any task involving sensitive, unpublished, or controlled-access data\n\n\n\nH.3.4 Core scientific skills\n\n❌ Bypassing reading original papers (especially in the first 1-3 years)\n❌ Using AI instead of asking labmates/mentors for help\n❌ Generating hypotheses or research questions\n❌ Tasks where discussion with colleagues provides more learning value",
556556
"crumbs": [
557557
"Appendices",
558558
"<span class='chapter-number'>H</span>  <span class='chapter-title'>LLM use guidelines for research trainees</span>"
@@ -563,7 +563,7 @@
563563
"href": "llm_use_guidelines.html#critical-requirements",
564564
"title": "Appendix H — LLM use guidelines for research trainees",
565565
"section": "H.4 Critical requirements",
566-
"text": "H.4 Critical requirements\n\nH.4.1 1. Accountability & verification\n\nYou are fully responsible for ALL AI-generated content\nVerification requires expertise - if you can’t verify output correctness, don’t use AI for that task\nFor code: Understand every line, test thoroughly\nFor writing: Fact-check every claim, verify every citation exists\nFor analysis: Verify statistical approaches, check assumptions\n\n\n\nH.4.2 2. Documentation\nWhen you use AI, document:\n\nTool name and version\nDate of use\nPrompts used\nOutput generated\nHow you verified/modified it\nErrors found and corrected\n\n\n\nH.4.3 3. Communication\n\nInform your PI within 1 week of AI use for research tasks\nBe transparent with collaborators before/during work\nNever present AI outputs as your own understanding\n\n\n\nH.4.4 4. Protect sensitive information\n☠️ Never input into public AI systems:\n\nUnpublished results or data\nProprietary datasets or code\nNovel research ideas or hypotheses\nPatient data or controlled-access information\nGrant proposals or manuscript drafts in development",
566+
"text": "H.4 Critical requirements\n\nH.4.1 1. Accountability & verification\n\nYou are fully responsible for ALL AI-generated content\nVerification requires expertise - if you can’t verify output correctness, don’t use AI for that task\nFor code: Understand every line, test thoroughly\nFor writing: Fact-check every claim, verify every citation exists\nFor analysis: Verify statistical approaches, check assumptions\n\n\n\nH.4.2 2. Documentation\nWhen you use AI, document:\n\nTool name and version\nDate of use\nPrompts used\nOutput generated\nHow you verified/modified the LLM output\nErrors found and corrected\n\n\n\nH.4.3 3. Communication\n\nInform your PI within 1 week of AI use for research tasks\nBe transparent with collaborators before/during work\nNever present AI outputs as your own understanding\n\n\n\nH.4.4 4. Protect sensitive information\n☠️ Never input into public AI systems:\n\nUnpublished results or data\nProprietary datasets or code\nNovel research ideas or hypotheses\nPatient data or controlled-access information\nGrant proposals or manuscript drafts in development",
567567
"crumbs": [
568568
"Appendices",
569569
"<span class='chapter-number'>H</span>  <span class='chapter-title'>LLM use guidelines for research trainees</span>"
@@ -596,7 +596,7 @@
596596
"href": "llm_use_guidelines.html#remember",
597597
"title": "Appendix H — LLM use guidelines for research trainees",
598598
"section": "H.7 Remember",
599-
"text": "H.7 Remember\n\nSpeed ≠ learning. Efficiency now can mean skill gaps later\nAI outputs look polished but may be wrong. Confidence ≠ correctness\nWhat distinguishes you: Deep thinking, original perspectives, robust foundational skills\nAI often introduces subtle errors that a human would not: these can lead to profound consequences\nHallucinations are real: Always verify citations, facts, and technical claims\nWhen in doubt, ask your PI first\nCheck LLM’s Settings → Privacy/Data controls` and turn off chat history, memory, personalization, and training‑related data usage for maximum privacy and no data retention.\n\n\n\nThe goal isn’t to avoid AI entirely — it’s to use it strategically so you emerge from training as an independent scientist with distinctive capabilities, not someone dependent on tools they can’t verify or correct. You will have ample opportunities as a PI or a scientist in an industry, to learn and use LLMs quickly and efficiently — there’s no need to rush into it now at the cost of your successful training.",
599+
"text": "H.7 Remember\n\nSpeed ≠ learning. Efficiency now can mean skill gaps later\nAI outputs look polished but may be wrong. Confidence ≠ correctness\nWhat distinguishes you: Deep thinking, original perspectives, robust foundational skills\nAI often introduces subtle errors that a human would not: these can lead to profound consequences\nHallucinations are real: Always verify citations, facts, and technical claims\nWhen in doubt, ask your PI first\nCheck LLM’s Settings → Privacy/Data controls` and turn off chat history, memory, personalization, and training‑related data usage for maximum privacy and no data retention.\n\n\nThe goal isn’t to avoid AI entirely — it’s to use it strategically so you emerge from training as an independent scientist with distinctive capabilities, not someone dependent on tools they can’t verify or correct. You will have ample opportunities as a PI or a scientist in an industry, to learn and use LLMs quickly and efficiently — there’s no need to rush into it now at the cost of your successful training.",
600600
"crumbs": [
601601
"Appendices",
602602
"<span class='chapter-number'>H</span>  <span class='chapter-title'>LLM use guidelines for research trainees</span>"

0 commit comments

Comments
 (0)