Skip to content

Commit c3bee52

Browse files
Antigravity Agentclaude
andcommitted
docs(zenodo): Add v6.0 quickstart guide for fast-track upload (#415)
Created comprehensive quickstart guide: - 3-step upload process - Per-bundle checklist - Troubleshooting section - Post-upload verification - Parent collection update guide All 7 bundles ready for upload with this guide. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent e673cff commit c3bee52

1 file changed

Lines changed: 170 additions & 0 deletions

File tree

Lines changed: 170 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,170 @@
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

Comments
 (0)