mozilla / ai-guide

Mozilla AI Guide
Mozilla Public License 2.0
29 stars 21 forks source link

Include a references section in each guide document #25

Open ashandoak opened 10 months ago

ashandoak commented 10 months ago

Please describe your problem or observation

While Mozilla is, I think in general, considered a trustworthy source, including a references section would help to reinforce that this guide is part of a larger research and educational effort.

The first two chapters of the guide (AI Basics and Language Models 101) are especially concerning: Given the large volume of technical terminology references would serve to further legitimize the guide. For anyone new to the space, a references section is a valuable tool for deeper learning.

Corollary: I don't think in-text citations are necessary. While they might be a nice addition (or even in-text hyperlinks for technical terms), the guide is not meant to be an academic paper, and including them may serve to distract the audience from the overall purpose of the guide.

Describe the solution you'd like to see

A detailed references section for each chapter pointing to valuable external resources that support the claims made in the guide.