The Ancient Atlas

Contribute a walkthrough
Phase 2 · Contributor flow

Add a walkthrough

Paste a YouTube URL : : pick the site and creator : : copy the JSON snippet : : open a pull request. The atlas grows by hand, one walkthrough at a time.

Before you start
  • The video must be a credible walkthrough or analysis of an ancient site already in the catalog. New sites go through the site proposal flow first.
  • This page generates the JSON. You'll paste it into data/videos.json on GitHub and open a pull request.
  • If you're not familiar with GitHub, that's fine. The final step links you directly to the right file with an in-browser editor.
1
Paste the YouTube URL
We'll fetch the title, channel, and thumbnail.
Generated snippet
Paste this under the matching site in data/videos.json.

      

      

        
        
          
          Open videos.json on GitHub
        
      

    


    

      
What happens next

      
    
        
  1. Click Open videos.json on GitHub. If you're not signed in, GitHub will prompt you.
    2. 
        
  2. GitHub will offer to fork the repo on your first edit. Accept it. This makes a personal copy in your account so you can suggest changes without affecting the main atlas.
    3. 
        
  3. In the editor, find the site name your video belongs to (Cmd+F to search). Each site has an array : "Site Name": [ ... ]. Paste your new entry inside the brackets, comma-separated from the others.
    4. 
        
  4. Scroll down and click Propose changes. Add a short note like "Add Praveen Mohan walkthrough for Karahan Tepe."
    5. 
        
  5. Click Create pull request. A maintainer reviews within 48 hours. Automated checks verify the YouTube ID is valid before merge.
    6.