Instructions for Updating Your GitHub Pages Site

Option 1: Using GitHub Web Interface (Easiest)

  1. Go to https://github.com/russt/russt.github.io

  2. Add/Replace index.md:
    • Click “Add file” → “Create new file”
    • Name it: index.md
    • Copy the contents from the index.md file I created
    • Scroll down and click “Commit new file”
    • If index.html exists, you may want to delete it or rename it
  3. Update _config.yml:
    • Navigate to the _config.yml file
    • Click the pencil icon (Edit this file)
    • Replace with the new contents
    • Click “Commit changes”
  4. Add projects.md:
    • Click “Add file” → “Create new file”
    • Name it: projects.md
    • Copy the contents
    • Click “Commit new file”
  5. Update about.md:
    • Navigate to about.md
    • Click the pencil icon
    • Replace with new contents
    • Click “Commit changes”
  6. Update README.md:
    • If it doesn’t exist, create it
    • Add the README content

Option 2: Using Git Locally

# Clone your repository
git clone https://github.com/russt/russt.github.io.git
cd russt.github.io

# Add the new files (use the files I created)
# Copy index.md, _config.yml, projects.md, about.md, README.md

# If you want to replace index.html with index.md:
git rm index.html  # optional

# Commit and push
git add .
git commit -m "Update site with VSPMS project landing page"
git push origin master

Verify It’s Working

  1. Wait 1-2 minutes for GitHub to rebuild your site
  2. Visit: https://russt.github.io
  3. You should see your new landing page!

Check GitHub Pages Status

  1. Go to your repository Settings
  2. Click “Pages” in the left sidebar
  3. You should see: “Your site is published at https://russt.github.io”

Next Steps

Once your site is live:

  1. Update your VSPMS repositories:
    • Go to github.com/russt/vspms → Settings → Edit “About”
    • Set Website to: https://russt.github.io
    • Do the same for vspms-go when you create it
  2. Customize the content:
    • Update the “About” page with your actual info
    • Add your email if you want to share it
    • Add more projects as needed
  3. Optional enhancements:
    • Add a custom domain if you have one
    • Customize the Jekyll theme
    • Add blog posts in the _posts/ directory
    • Add project-specific documentation pages

Troubleshooting

If the site doesn’t appear after a few minutes:

  1. Check Settings → Pages to ensure GitHub Pages is enabled
  2. Make sure the source is set to “master” branch, root folder
  3. Check the Actions tab to see if the build succeeded
  4. Look for any error messages in the build logs