|
| 1 | +# Zenodo v6.0 — Quickstart Guide |
| 2 | + |
| 3 | +**Version:** 6.0 |
| 4 | +**Date:** 2026-03-26 |
| 5 | +**Purpose:** Fast-track Zenodo upload for Trinity S³AI bundles |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## Quick Start (3 Steps) |
| 10 | + |
| 11 | +### Step 1: Prepare Upload Files |
| 12 | + |
| 13 | +For each bundle (B001-B007), gather: |
| 14 | + |
| 15 | +``` |
| 16 | +docs/research/ |
| 17 | +├── zenodo_B*_enhanced_v5.2.md (Rename to zenodo_B*_v6.0.md) |
| 18 | +├── figures/ |
| 19 | +│ ├── BXXX-Fig1_*.png |
| 20 | +│ └── BXXX-Fig2_*.png |
| 21 | +└── data/ |
| 22 | + └── BXXX_*.csv (supplementary) |
| 23 | +``` |
| 24 | + |
| 25 | +**File Upload Order:** |
| 26 | +1. Main description (`zenodo_B*_v6.0.md`) |
| 27 | +2. Figures (PNG + SVG) — use "upload multiple" if available |
| 28 | +3. Supplementary data (CSV) |
| 29 | +4. Code archive (if publishing new version) |
| 30 | + |
| 31 | +### Step 2: Update Metadata |
| 32 | + |
| 33 | +Edit `.zenodo.B*_v6.0.json`: |
| 34 | + |
| 35 | +```json |
| 36 | +{ |
| 37 | + "title": "B001: Ternary Neural Networks — Complete Scientific Framework v6.0", |
| 38 | + "creators": [ |
| 39 | + { |
| 40 | + "name": "Vasilev, Dmitrii", |
| 41 | + "orcid": "YOUR_ORCID_HERE", // ← UPDATE THIS |
| 42 | + "affiliation": "Independent Researcher", |
| 43 | + "type": "Person" |
| 44 | + } |
| 45 | + ], |
| 46 | + "keywords": [ |
| 47 | + "Artificial Intelligence", |
| 48 | + "Neural Networks", |
| 49 | + "Ternary Computing", |
| 50 | + "HSLM", |
| 51 | + "1.58-bit LLM", |
| 52 | + "Balanced Ternary", |
| 53 | + "Zig Language", |
| 54 | + "Zero Dependencies" |
| 55 | + ], |
| 56 | + "related_identifiers": [ |
| 57 | + { |
| 58 | + "scheme": "doi", |
| 59 | + "identifier": "10.5281/zenodo.19227733", |
| 60 | + "relation": "references" |
| 61 | + } |
| 62 | + ] |
| 63 | +} |
| 64 | +``` |
| 65 | + |
| 66 | +### Step 3: Upload to Zenodo |
| 67 | + |
| 68 | +1. Go to https://zenodo.org/deposit/new |
| 69 | +2. Select "Software" as resource type |
| 70 | +3. Fill in all fields from JSON metadata |
| 71 | +4. Upload files in order from Step 1 |
| 72 | +5. **DO NOT PUBLISH** — save as draft first |
| 73 | +6. Preview → Check all links and figures |
| 74 | +7. Publish → Get new DOI |
| 75 | + |
| 76 | +--- |
| 77 | + |
| 78 | +## Upload Checklist per Bundle |
| 79 | + |
| 80 | +| Field | B001 | B002 | B003 | B004 | B005 | B006 | B007 | |
| 81 | +|-------|------|------|------|------|------|------|------| |
| 82 | +| Description v6.0 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| 83 | +| Figure 1 (PNG) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| 84 | +| Figure 2 (PNG) | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | |
| 85 | +| Supplementary CSV | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| 86 | +| Metadata JSON | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | |
| 87 | +| DOI (v5.2) | 19227733 | 19227735 | 19227737 | 19227739 | 19227741 | 19227743 | 19227745 | |
| 88 | + |
| 89 | +**Note:** v6.0 will receive NEW DOIs — do not reuse v5.2 DOIs! |
| 90 | + |
| 91 | +--- |
| 92 | + |
| 93 | +## Estimated Time |
| 94 | + |
| 95 | +- Per bundle: 15-20 minutes (including metadata entry) |
| 96 | +- Total (7 bundles): 2-3 hours |
| 97 | +- Parent collection: 30 minutes (after all bundles) |
| 98 | + |
| 99 | +--- |
| 100 | + |
| 101 | +## Troubleshooting |
| 102 | + |
| 103 | +### Issue: Figure Not Displaying |
| 104 | + |
| 105 | +**Check:** |
| 106 | +- File path in markdown uses `figures/` subdirectory |
| 107 | +- Case-sensitive filenames |
| 108 | +- PNG/SVG files are uploaded (not only markdown) |
| 109 | + |
| 110 | +**Fix:** |
| 111 | +- Use relative path: `figures/B001-Fig1_training_curve.png` |
| 112 | +- Verify files exist in upload list |
| 113 | + |
| 114 | +### Issue: Metadata Validation Failed |
| 115 | + |
| 116 | +**Common errors:** |
| 117 | +1. **Missing ORCID** — Add ORCID ID |
| 118 | +2. **Keywords < 5** — Add more keywords |
| 119 | +3. **Abstract < 100 chars** — This is OK (Zenodo doesn't enforce limit) |
| 120 | +4. **Invalid DOI** — Do not include in metadata (Zenodo assigns new DOI) |
| 121 | + |
| 122 | +### Issue: Upload Size Limit |
| 123 | + |
| 124 | +**Zenodo limit:** 50 GB per deposit |
| 125 | + |
| 126 | +**Bundle sizes (estimated):** |
| 127 | +- B001: ~5 MB (description + 2 figures + data) |
| 128 | +- B002: ~5 MB (description + 2 figures + data) |
| 129 | +- B003: ~4 MB (description + 1 figure + data) |
| 130 | +- B004: ~4 MB (description + 1 figure + data) |
| 131 | +- B005: ~4 MB (description + 1 figure + data) |
| 132 | +- B006: ~5 MB (description + 2 figures + data) |
| 133 | +- B007: ~5 MB (description + 2 figures + data) |
| 134 | + |
| 135 | +**Total per bundle:** ~4-5 MB — well under limit |
| 136 | + |
| 137 | +--- |
| 138 | + |
| 139 | +## Post-Upload Verification |
| 140 | + |
| 141 | +After publishing each bundle, verify: |
| 142 | + |
| 143 | +1. **DOI resolves:** Open `https://doi.org/10.5281/zenodo.XXXXXX` |
| 144 | +2. **Files downloadable:** Test download links for all files |
| 145 | +3. **Figures render:** View online preview to check figures |
| 146 | +4. **Metadata correct:** Title, author, keywords display properly |
| 147 | +5. **Links work:** Related identifiers link to correct bundles |
| 148 | + |
| 149 | +--- |
| 150 | + |
| 151 | +## Parent Collection (v6.0) |
| 152 | + |
| 153 | +After all 7 bundles are published: |
| 154 | + |
| 155 | +1. Go to parent collection (DOI: 10.5281/zenodo.19225187) |
| 156 | +2. Update description to reference all new v6.0 DOIs |
| 157 | +3. Update links table with new DOI links |
| 158 | +4. Publish parent collection |
| 159 | + |
| 160 | +--- |
| 161 | + |
| 162 | +## Contact & Support |
| 163 | + |
| 164 | +- **Zenodo Help:** https://help.zenodo.org/ |
| 165 | +- **Trinity Issues:** https://github.com/gHashTag/trinity/issues |
| 166 | +- **ORCID Lookup:** https://orcid.org/ |
| 167 | + |
| 168 | +--- |
| 169 | + |
| 170 | +φ² + 1/φ² = 3 | TRINITY |
0 commit comments