Static Portfolio Hosting

• GitHub Pages: Free static web hosting directly from GitHub repositories.
• Main Portfolio: byandell.github.io (source), modeled on Jekyll Now.
• Subpages (separate repos):
  • Documentation (source): Digital Tools
  • geyser (source): Shiny App with Modules
  • landmapyr (source): Land Mapping Package
  • esiil-stars (source): ESIIL Stars Training
  • ESIIL (source): ESIIL Research

Static Generators & Themes

• Jekyll: Default Ruby-based builder used by GitHub Pages. Fast setup using forkable themes.
• MkDocs: Advanced Python-based alternative for technical docs.
  • Deploys layouts using themes like Material for MkDocs.
  • See Deploying your docs.

Git Troubleshooting & Help

• Happy Git with R: Standard resource for onboarding and troubleshooting.
  • Get Started with GitHub
  • Git Troubleshooting
• UW-Madison DataScience:
  • GitHub Links
• Git Clients & Setup:
  • Install Git for Windows (Git-SCM)
  • Install Git Guides

Organization Structure

• Collaboration: Allows teams/individuals to manage related repositories.
• Roles & Permissions: Owners manage members/repos. Repos can be public or private with 5 permission levels (read, triage, write, maintain, admin).
• Profile Repos: Special .github repositories can store an organization-level profile README.md (e.g., byandell-envsys or byandell-sysgen using <details> HTML tabs).

Reference Guides

• GitHub Organizations Docs (GitHub)
• Create an Org from Scratch (GeeksforGeeks)
• Managing an Organization (Git SCM)
• Why Use an Org? (How-To Geek)

Key Organizations

• My Orgs: byandell-envsys | byandell-sysgen
• UW-Madison: DSI | Data Science Hub
• ESIIL: ESIIL Hub | ESIIL Edu | Earth Lab
• OLC: Geospatial Hub

Enterprise Sharing Platform

• Posit Connect: Deployment platform to host R Shiny applications, Quarto documents, and python web models.
• Environment Replication: Connect uses the renv package to capture local project dependencies and rebuild them on the server.
• GitHub Integration: Packages installed via standard devtools (devtools::install_github) can lead to package resolution issues on compilation.

The Unknown Source Bug

• Symptoms: RStudio displays Deployment error: unknown package source.
• Cause: Packages installed via devtools may lack complete lockfile metadata. Connect is unable to determine the precise repository source, and deployment fails.

The renv Caching Solution

Force renv to explicitly write the GitHub source link to the lockfile:

# Install package through renv API
renv::install("github_user/package_name")

# Snapshot changes to renv.lock
renv::snapshot()

If it still fails, record the source metadata manually:

renv::record("github_user/package_name")

Dynamic Cloud Workspaces

• GitHub Codespaces: Instant, preconfigured container development workspaces hosted in the cloud.
• Fast Onboarding: Integrates seamlessly with Git repositories, preloading extensions, scripts, and runtime dependencies.
• VS Code Integration: Develop directly in your web browser or connect via local Visual Studio Code remote editors.