Skip to content

Phase 1: update the Lucknow AI Labs site (content, structure, events data, CI) - #32

Open
PrashantShuklaa wants to merge 6 commits into
mainfrom
phase1/lai-site
Open

PrashantShuklaa wants to merge 6 commits into
mainfrom
phase1/lai-site

Conversation

@PrashantShuklaa

@PrashantShuklaa PrashantShuklaa commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Phase 1 update of the Lucknow AI Labs site, still on Jekyll and the Just the Docs theme. Every page is rewritten or fixed, events and projects are data-driven, old links keep working, and every PR now gets an automatic build and link check.

Review commit by commit:

  1. Cleanup: removes 5,433 files that never belonged in the repo (node_modules, _site build output, theme dev files, demo pages, unused images).
  2. Structure and content: the actual site changes. This is the one to read.
  3. Tooling: local preview (Docker or Ruby), CI site check, README.
  4. Small addition: CI uploads the built site so you can preview without installing anything.

Test it on your Mac

cd ~/Documents/GitHub/UPAI_labs/lucknowai.github.io
git status                  # nothing uncommitted in the way
git fetch origin
git checkout phase1/lai-site
docker compose up           # then open http://localhost:4000

No Docker? See "Run it on your computer" in the README (Homebrew Ruby, bundle install, bundle exec jekyll serve). Both use the same gems as GitHub Pages.

Or, with nothing installed: open the Site check run on this PR → Summary → download built-site → unzip and open index.html. Links that start with / work best through the local server.

What changed

Area Before After
Addresses /docs/configuration/ (About), /docs/ui-components (Research), /docs/layout/Events%20&%20Meetups/... /about/, /research/, /events/2024-05-25-genai-awadh-summit/. Every old address redirects.
Events 18 hand-made pages, last one Apr 2025 One data file (_data/events.yml) with 53 events, Nov 2023 to Nov 2026, taken from the old pages and Commudle (UPAI Labs + AI Community Lucknow, events and hackathon tabs). Each event shows its organiser as listed at the source. Events, Hackathons and Home are generated from it.
Upcoming None DevFest Lucknow, 14 Nov 2026, on Home and Events. It hides itself once the date passes.
Home Docs-style page, dead "Try Nawab-AI" button, "Alt text" placeholders Chapter 1 of UPAI Labs, next event, what we do, stats calculated from the data (52 events, 6 hackathons, 12 paper reading sessions, 9 active projects), recent events, join channels
About 2023 personal letter ("no one is paid or sponsored") Chapter story, milestones, how we work, who runs it; founder's note kept as a quote
Research "Coming Soon" Paper reading, Awadhi project (with the recording site), areas of work
Projects Two projects, one "Coming Soon" 9 active + 7 earlier projects, described from their READMEs, with last-updated dates
FAQs 3 pages; "LAI is a nonprofit", "rely on donations" One page; "chapter of UPAI Labs Foundation (Section 8)", no donation language
Code of conduct Reports went to patrick.marsceill@gmail.com (the theme author) hello@upailabs.org
Team Two members linked to example.com Real link or no link
Footer "© 2017-2020 ... powered by Netlify" "© 2023-2026 Lucknow AI Labs, a chapter of UPAI Labs Foundation..."
Look Default dark theme Dark theme with the UPAI Labs yellow accent
Weight Portraits ~250 KB each, logo 178 KB ~30 KB each, logo 24 KB
SEO url: http://lucknowai.org/ (a redirect), no sitemap https://lucknowai.github.io, page descriptions, sitemap.xml

Bugs fixed in event pages: the Django meetup page had broken front matter and never showed in the menu; the Google I/O Extended 2024 page said "September 10, 2023"; "Discrod", "Orgnised", "collabration".

Needs your input before merge

Marked defaults are what's in the PR now.

  • Awadh AI Summit (1 Nov) and Hacktoberfest hack day (31 Oct): did they happen? Send date, venue, partners and a few photos. They're in _data/events.yml with status: unconfirmed and hidden until then.
  • DevFest Lucknow 2026: organiser shown as "GDG Lucknow, with UPAI Labs and AI Community Lucknow". Confirm, and send the venue.
  • Founding team wording (About and Team): "Ankit Kumar Pal (Aaditya), Prashant Shukla and Abhishek Sahu". OK?
  • Team page: are Harsh Joshi, Gauraangi and Kaif still active and happy to be listed? Kaif has no profile link.
  • Jamie or Jaime? The voice-assistant meetup page says "Jamie"; the video file says "Jaime".
  • Research page: "Areas we work on" lists low-resource Indian languages, document and image understanding, and applied agents. OK to show publicly?
  • Mentorship and volunteer Google Forms: is anyone reading responses? If not, I'll mark mentorship "closed for now".
  • Recording: the 58 MB meetup video is still in the repo. If you upload it to YouTube, I'll link it instead.
  • Events I couldn't find (Dec 2023; Mar, Jul, Sep 2024; Jul, Dec 2025; Jan, Jun, Aug 2026). Anything missing?

Checks

  • Every page's front matter parses; every parent: matches a page; every internal link and asset path exists (checked with a script before pushing).
  • The Site check workflow on this PR builds with the github-pages gem and runs html-proofer on all internal links and images.

Not in this PR



Generated by Claude Code

The repository was a fork of the Just the Docs theme repository and still
carried its development files. None of this is used to build the site.

- node_modules/ (5,296 files) and _site/ (old build output) were committed
- Theme development files: gemspec, Rakefile, lib/, bin/, fixtures/,
  CHANGELOG.md, MIGRATION.md, package.json (theme linting)
- Theme demo pages: UI components, utilities and "minimal layout" pages
- Unused images (theme samples, an old home-page illustration) and an
  unreferenced PDF; .DS_Store files
- .gitignore now covers build output, local gems and OS files

Tracked files go from 5,582 to about 150. The live site is unaffected:
GitHub Pages builds from source.
Structure
- Clean addresses: /about/, /events/, /hackathons/, /projects/, /research/,
  /team/, /get-involved/, /volunteer/, /mentorship/, /resources/, /faqs/,
  /contact/. Every old address (/docs/configuration/, /docs/ui-components,
  "/docs/layout/Events & Meetups/...", the FAQ pages, etc.) redirects to its
  new page via jekyll-redirect-from, so shared links keep working.
- Menu: Home, About, Events, Hackathons, Projects, Research, Team,
  Get involved, Resources, FAQs, Contact, Code of Conduct.

Data-driven events and projects
- _data/events.yml lists all 53 published events from Nov 2023 to Nov 2026,
  compiled from the old event pages and the Commudle listings of UPAI Labs
  and AI Community Lucknow (events, hackathons). Each entry names the
  organiser as listed at the source. Two events awaiting confirmation are
  kept off the site.
- Events page (upcoming first, then by year), Hackathons page, Home
  "next event", "recent events" and stats are all generated from it.
  Upcoming entries hide themselves in the browser once their date passes.
- _data/projects.yml: active and earlier projects, descriptions taken from
  each repository's README.

Content
- Home: Chapter 1 of UPAI Labs, next event (DevFest Lucknow, 14 Nov 2026),
  what we do, computed stats, recent events, join channels. Removed the
  dead "Try Nawab-AI" link, placeholder alt text and a third-party
  illustration.
- About: replaces the 2023 personal letter with the chapter story,
  milestones and how the community works; keeps an excerpt of the
  founder's note. Drops "no one is paid or sponsored".
- Research: replaces "Coming Soon" (paper reading, Awadhi project).
- Projects: replaces the "Coming Soon" page; NAWAB AI page rewritten from
  its README.
- FAQs: three FAQ pages merged; "Lucknow AI Labs is a nonprofit" corrected
  to "chapter of UPAI Labs Foundation (Section 8)"; no donation language.
- Contact: email hello@upailabs.org plus channels; removed CSS that forced
  white headings.
- Code of conduct: reports went to the theme author's personal email
  (patrick.marsceill@gmail.com); now hello@upailabs.org.
- Team (AI Baithak): replaced example.com placeholder links; mentorship and
  volunteer pages cleaned up (forms kept); new Get involved page.
- Footer: "2017-2020 ... powered by Netlify" replaced with the correct
  credit line.

Fixes in event pages
- Django meetup page had broken front matter (missing ---) and did not
  appear in the menu.
- Google I/O Extended 2024 page said "September 10, 2023".
- Typos: "Discrod", "Orgnised", "collabration".
- Recap pages sorted newest first; GDSC WOW page (empty) removed.

Look and speed
- Dark theme with the UPAI Labs yellow accent; readable dark text on
  primary buttons.
- Team portraits 250 KB to 30 KB each; logo 178 KB to 24 KB.
- SEO: correct site URL (https://lucknowai.github.io), descriptions on
  every page, sitemap.xml (jekyll-sitemap).
- Gemfile now uses the github-pages gem, so local builds use the same
  Jekyll version and plugins as GitHub Pages (local runs used Jekyll 4
  through the theme gemspec while GitHub builds with Jekyll 3).
- Dockerfile and docker-compose.yml: `docker compose up` serves the site
  at http://localhost:4000 with live reload; no Ruby install needed.
- .github/workflows/site-check.yml: on every pull request and push to
  main, builds the site with the GitHub Pages gems and checks every
  internal link and image with html-proofer.
- README: how to run locally (Docker, or Ruby via Homebrew on macOS),
  where things are, how to add an event or a project, and how old links
  are kept working.
The new step fails the check if the Events page does not list every
published past event, the next upcoming event is missing from Home, the
Home stats are missing, or any page contains a Liquid error. Dates are
now worked out in Asia/Kolkata time.

Copy link
Copy Markdown
Contributor Author

Site check results (latest commit, built with github-pages v233 / Jekyll 3.10.0, the same as the live site):

  • Build: clean, no warnings
  • Events page lists 52 past events = 52 published past events in _data/events.yml
  • Home shows the next event: DevFest Lucknow 2026 (14 Nov)
  • Home stats: 52 events, 6 hackathons, 12 paper reading sessions, 9 active projects
  • No Liquid errors on any page
  • html-proofer: 71 generated pages, all internal links and images resolve, including every redirect from the old addresses

The check now runs on every PR and push to main, and fails if the Events page and the data file ever disagree.


Generated by Claude Code

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant