draft external-facing FAQ for arcticdata.io

[vlraymond]

Existing INTERNAL (data-team only) FAQ:

• https://nceas.github.io/datateam-training/using-rt.html#other-faqs
• https://github.nceas.ucsb.edu/KNB/arctic-data/blob/master/datateam/How_To/RT/email_templates.md
• https://nceas.github.io/datateam-training/reference/pi-faqs.html
• https://nceas.github.io/datateam-training/reference/email-templates.html

New EXTERNAL (user-facing) FAQ

Draft user-facing FAQ - for review from Data team

next steps:

• [x] VR create .md with ToContents
• [x] VR share FAQ.md to data team for review and additions (was done on 4/18)
• [x] data/support team provides feedback by 4/30
• [x] Merge commits for FAQ and Submission page (5/4)
• [ ] VR / KM add FAQ to website, see if dev team has any better ideas for integration beyond just the FAQ page (5/13)

[vlraymond]

FAQ and helper text should link to EML FAQ https://knb.ecoinformatics.org/#external//emlparser/docs/eml-2.1.1/eml-faq.html

[jagoldstein]

updated links to existing FAQ: https://nceas.github.io/datateam-training/reference/pi-faqs.html which I would like to move to include here instead: https://nceas.github.io/datateam-training/reference/email-templates.html (see https://github.com/NCEAS/datamgmt/issues/124)

I will review the new Draft FAQ (sorry we didn't get to this sooner). @vlraymond do you prefer that I fork the repo and make editing suggestions as pull requests or should I just push my changes?

[vlraymond]

@jagoldstein I guess I'd just make a new branch w your edits.

No worries, I didn't ask you all to look at it until just y'day because I felt like there was a lot on your plate with testing the editor, new fellowship applications, etc.

[jagoldstein]

ok @vlraymond I submitted a PR with my edits to merge my branch to the master

[vlraymond]

So I reviewed Jesse's PR. I don't think I have write permissions to commit the PR (or II am doing this wrong)... anyways so it's reviewed but not committed. @mbjones

[jagoldstein]

@kameyer we are clear to go ahead and update this page with the content from here

[kameyer]

great, thanks @jagoldstein!

[kameyer]

The FAQ page on the website has been updated with the improved content (https://arcticdata.io/q-and-a/)

[jagoldstein]

@kameyer this is great, thanks! I just noticed one minor formatting issue:

these 3 hyphenated points should each be on a separate line (bulleted), or simply turned into a sentence with a list.

[kameyer]

Edited to make the answer a sentence (and gave Large Files and Submitting Code and Scripts there own linked headers in the Table of Contents list)