Complete guide for managing the Regis University Portfolio system
This system provides a centralized platform for showcasing Regis University Data Science students' practicum projects across multiple semesters. As an instructor, you'll manage one repository that maintains historical data while highlighting current and exceptional work through the spotlight feature.
Supports both MSDS 692 (Practicum I) and MSDS 696 (Practicum II) courses in the Data Science Master's program.
Follow this streamlined process for each new semester. The system is designed to minimize manual work while maintaining professional quality and consistency across all student portfolios.
Create and upload student roster CSV file to the regis_std repository
Execute automated system to create student folders and templates
Generate and deploy final portfolios to the main website
Skip manual setup! Upload a CSV file and let our automation system create professional portfolios for all your students automatically.
Access Portfolio System2025_Summer_MSDS692.csv
Student Name,Email,Username,Project_Title,GitHub_Profile,Practicum_1_GitHub,LinkedIn_Profile,Portfolio_Page "John Doe","jdoe@regis.edu","jdoe001","ML Trading Bot","https://github.com/jdoe001/ml-trading","","","" "Jane Smith","jsmith@regis.edu","jsmith002","Data Analytics Platform","https://github.com/jsmith002/data-platform","","",""
✅ Email cleaning automatic (@worldclass → @regis)
✅ Professional templates generated
✅ Course folders organized by semester
Create a CSV file with student information and upload it to the regis_std repository data folder.
File naming convention: YYYY_Semester_CourseCode.csv
2025_Summer_MSDS692.csv2025_Summer_MSDS696.csvStudent Name,Email,Username,Project_Title,GitHub_Profile,Practicum_1_GitHub,LinkedIn_Profile,Portfolio_Page John Doe,jdoe@regis.edu,jdoe001,ML Trading Bot,,,, Jane Smith,jsmith@regis.edu,jsmith002,Data Analytics Platform,,,,
Execute the automation to create individual student folders and templates.
Creates folder structure, profile templates, and README files for each student
/data/students/{username}/ folderprofile.md templateREADME.md with instructionsStudents access their assigned folders in the portfolio system and upload project materials according to the Student Guide.
Students save files to: https://github.com/iamgmujtaba/regis_std/tree/main/data/students/{username}/
presentations/{username}_practicum_slides.pdfreports/{username}_practicum_report.pdfavatar.jpg or avatar.pngRun the portfolio generation system to convert markdown files to professional HTML portfolios and deploy to the website.
Converts markdown to HTML, applies Regis branding, and publishes to website
Each student gets a professional portfolio at: https://iamgmujtaba.github.io/profiles/{username}.html
All portfolios are automatically added to the main course website with proper navigation and search functionality.
Spotlight projects are exceptional student work featured prominently on the homepage. They showcase the best examples across all semesters and inspire current students.
Spotlight projects are manually curated by instructors. To add a project to the spotlight section, update the spotlight.json file in the main repository's data folder:
data/spotlight.json (main repository)
Note: This is separate from the CSV workflow and requires manual editing.
{
"spotlightProjects": [
{
"studentName": "Alice Johnson",
"semester": "spring-2025",
"projectTitle": "ML-Based Predictive Analytics Platform",
"description": "Innovative platform using advanced ML algorithms for real-time data analysis...",
"github": "https://github.com/alicejohnson/ml-analytics",
"demo": "https://alice-demo.herokuapp.com",
"profilePage": "profiles/ajohnson.html",
"tags": ["Machine Learning", "Analytics", "Python", "Real-time"],
"achievements": ["Best Technical Innovation", "Industry Partnership Award"],
"semester": "2025-spring",
"course": "MSDS696"
}
]
}
regis_std/
├── data/
│ ├── 2025_Summer_MSDS692.csv
│ ├── 2025_Summer_MSDS696.csv
│ ├── students/
│ │ ├── jdoe001/
│ │ │ ├── profile.md
│ │ │ ├── README.md
│ │ │ ├── presentations/
│ │ │ ├── reports/
│ │ │ └── avatar.jpg
│ │ └── jsmith002/
│ │ ├── profile.md
│ │ └── ...
├── scripts/
│ ├── generate_json.py
│ ├── process_csv.py
│ └── sync-to-portfolio.py
└── .github/workflows/
├── setup-students.yml
└── deploy-portfolios.yml
Trigger: Upload CSV file to data/ folder
Actions:
Trigger: Manual or scheduled
Actions:
YYYY_Semester_CourseCode.csvdata/spotlight.json are maintained manuallyDownload template:
Download CSV Template
Required columns: Student Name, Email, Username, Project Title
Optional: GitHub, Presentation, Report, Blog, Other, Demo
Share this professional LaTeX template with your students for writing their practicum reports with proper academic formatting:
Professional LaTeX template for MSDS 692/696 reports with Regis branding