Improve Excel ingest documentation for troubleshooting
Nobody has claimed this yet.
- Dominant language
- Java
- Stars
- 1.1k
- Forks
- 564
- Avg merge
- 2d 2h
- Merged PRs (30d)
- 29
Description
Hi! We have had questions about excel data upload failures and the existing documentation here isn't very helpful for troubleshooting unfortuantely
https://guides.dataverse.org/en/latest/user/tabulardataingest/excel.html
It would be helpful if there was a template or list of conditions provided here for end users to troubleshoot why their data failed to load. An example of an acceptable spreadsheet structure would also be great, even visuals.
Is this something that can be developed to support users? I'm not familiar with all the conditions and exceptions for Excel data upload but perhaps this is something you have mapped out?
Thanks in advance,
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the linked Excel ingest guide at guides.dataverse.org/en/latest/user/tabulardataingest/excel.html and review the current upload-failure guidance. Identify the conditions users need to check, then document them as a troubleshooting checklist and add an acceptable spreadsheet example or visual; the guide should let users diagnose common failures without maintainer help.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100