Merge pull request #26 from phuse-org/white-paper-draft

kieranjmartin · web-flow · commit 82538fb2fdb1 · 2025-05-22T16:53:57.000+01:00
White paper draft
diff --git a/.github/workflows/publish-quarto.yaml b/.github/workflows/publish-quarto.yaml
@@ -30,12 +30,18 @@ jobs:
           # uncomment below and fill to pin a version
           # version: SPECIFIC-QUARTO-VERSION-HERE
           
-      - name: Render Quarto Project
+      - name: Render Quarto Project 1
         uses: quarto-dev/quarto-actions/render@v2
         with:
           to: html # If set, it will be equivalent to `quarto render --to html`
           path: site
       
+      - name: Render Quarto Project 2
+        uses: quarto-dev/quarto-actions/render@v2
+        with:
+          to: html # If set, it will be equivalent to `quarto render --to html`
+          path: white-paper    
+      
       - name: Upload static files as artifact
         id: deployment
         uses: actions/upload-pages-artifact@v3
diff --git a/site/_quarto.yml b/site/_quarto.yml
@@ -6,9 +6,14 @@ website:
   title: "Git in Statistical Programming"
   navbar:
     right:
-      - about.qmd
+      - href: index.qmd
+        text: Home
+      - posts.qmd
+      - href: white-paper/index.html
+        text: White Paper
       - icon: github
-        href: https://github.com/
+        href: https://github.com/phuse-org/git-in-statistical-programming
+        
 
 format:
   html:
diff --git a/site/about.qmd b/site/about.qmd
diff --git a/site/index.qmd b/site/index.qmd
@@ -1,14 +1,27 @@
 ---
 title: "Git in Statistical Programming"
-listing:
-  contents: posts
-  sort: "date desc"
-  type: default
-  categories: true
-  sort-ui: false
-  filter-ui: false
-page-layout: full
-title-block-banner: true
+about:
+  image: phuselogo.png
+  template: solana
+  links:
+    - icon: github
+      text: Github
+      href: https://github.com/phuse-org/git-in-statistical-programming
+      
 ---
 
+This blog contains posts from the PHUSE working group on The use of Git in Statistical Programming
 
+# Meetings
+
+Meetings are happening bi-weekly every Friday
+
+# Goal
+
+- White paper about Git in pharma for statisticians : Guidelines
+- Poster for Europe PHUSE 2025
+
+# Content
+
+- [White Paper draft](white-paper/index.html)
+- [Blog posts](posts.qmd)
diff --git a/site/posts.qmd b/site/posts.qmd
@@ -0,0 +1,19 @@
+---
+title: "Git in Statistical Programming blog"
+listing:
+  - id: posts
+    contents: "posts"
+    type: default
+    fields: [image, date, title, subtitle, categories, author, reading-time]  
+    sort: "date desc"
+    # categories: cloud
+    sort-ui: true
+    filter-ui: true
+    page-size: 10
+page-layout: full
+title-block-banner: false
+---
+
+
+::: {#posts}
+:::
diff --git a/white-paper/.gitignore b/white-paper/.gitignore
@@ -0,0 +1 @@
+/.quarto/
diff --git a/white-paper/Challenges.qmd b/white-paper/Challenges.qmd
@@ -0,0 +1,5 @@
+# Change Management and Git
+
+This chapter will discuss challenges in adoption of Git as well as how these might be addressed.
+
+
diff --git a/white-paper/_quarto.yml b/white-paper/_quarto.yml
@@ -0,0 +1,27 @@
+project:
+  type: book
+  output-dir: ../docs/white-paper
+book:
+  title: "Git in Statistical Programming"
+  author: "Kieran Martin"
+  date: "5/22/2025"
+  chapters:
+    - index.qmd
+    - state.qmd
+    - Challenges.qmd
+    - audittrail.qmd
+    - qcintegration.qmd
+    - recommendations.qmd
+    - summary.qmd
+    - references.qmd
+  appendices:
+     - tools.qmd
+
+bibliography: references.bib
+
+format:
+  html:
+    theme: cosmo
+
+
+
diff --git a/white-paper/audittrail.qmd b/white-paper/audittrail.qmd
@@ -0,0 +1,5 @@
+# Audit trail requirements and Git
+
+This chapter will discuss audit trail requirements for QC, and how they might be met in Git. 
+
+
diff --git a/white-paper/cover.png b/white-paper/cover.png
diff --git a/white-paper/index.qmd b/white-paper/index.qmd
@@ -0,0 +1,4 @@
+# Introduction
+
+This is a draft of the white paper for the phuse working group Git in Statistical Programming
+
diff --git a/white-paper/phuselogo.png b/white-paper/phuselogo.png
diff --git a/white-paper/qcintegration.qmd b/white-paper/qcintegration.qmd
@@ -0,0 +1,5 @@
+# QC Process and Git
+
+This chapter will discuss the QC process and how teams might interact with that using Git.
+
+
diff --git a/white-paper/recommendations.qmd b/white-paper/recommendations.qmd
@@ -0,0 +1,4 @@
+# Recommended ways of using Git
+
+This chapter will discuss the working groups current recommendations for using Git. These are not intended to be authoritative, or cover every scenario, but instead look at commonalities between current usage of Git, and how new companies might adopt it. 
+
diff --git a/white-paper/references.bib b/white-paper/references.bib
@@ -0,0 +1,19 @@
+@article{knuth84,
+  author = {Knuth, Donald E.},
+  title = {Literate Programming},
+  year = {1984},
+  issue_date = {May 1984},
+  publisher = {Oxford University Press, Inc.},
+  address = {USA},
+  volume = {27},
+  number = {2},
+  issn = {0010-4620},
+  url = {https://doi.org/10.1093/comjnl/27.2.97},
+  doi = {10.1093/comjnl/27.2.97},
+  journal = {Comput. J.},
+  month = may,
+  pages = {97–111},
+  numpages = {15}
+}
+
+
diff --git a/white-paper/references.qmd b/white-paper/references.qmd
@@ -0,0 +1,4 @@
+# References {.unnumbered}
+
+::: {#refs}
+:::
diff --git a/white-paper/state.qmd b/white-paper/state.qmd
@@ -0,0 +1,3 @@
+# The state of Git usage across the industry
+
+This section will describe the current state of Git in the industry
diff --git a/white-paper/summary.qmd b/white-paper/summary.qmd
@@ -0,0 +1,3 @@
+# Summary
+
+In summary, this book has no content whatsoever.
diff --git a/white-paper/tools.qmd b/white-paper/tools.qmd
@@ -0,0 +1,4 @@
+# Tools for using Git
+
+This chapter will discuss the tools that can be used in Git. This is intended to be a reference rather than recommendations
+
diff --git a/white-paper/white-paper.Rproj b/white-paper/white-paper.Rproj
@@ -0,0 +1,13 @@
+Version: 1.0
+
+RestoreWorkspace: Default
+SaveWorkspace: Default
+AlwaysSaveHistory: Default
+
+EnableCodeIndexing: Yes
+UseSpacesForTab: Yes
+NumSpacesForTab: 2
+Encoding: UTF-8
+
+RnwWeave: Knitr
+LaTeX: pdfLaTeX

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +# Change Management and Git
++
 +This chapter will discuss challenges in adoption of Git as well as how these might be addressed.
++
++