Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Include a references section in each guide document #25

Open
ashandoak opened this issue Nov 1, 2023 · 0 comments
Open

Include a references section in each guide document #25

ashandoak opened this issue Nov 1, 2023 · 0 comments

Comments

@ashandoak
Copy link

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant