docs: "Frequently Asked Questions" page

[iuioiua]

First pass. Other questions that should be answered:

1. Why is the Standard Library versioned differently to the Deno runtime?
2. What are the compatibility guarantees for the Standard Library?

@kt3k, are you able to handle these?

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.44%. Comparing base (4398642) to head (7670951).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4722   +/-   ##
=======================================
  Coverage   91.44%   91.44%           
=======================================
  Files         480      480           
  Lines       37318    37318           
  Branches     5316     5316           
=======================================
  Hits        34126    34126           
  Misses       3136     3136           
  Partials       56       56           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[kt3k]

deno add <pkg> adds import map entry with the form of "@std/foo": "jsr:@std/foo@^1.2.3". The above example seems slightly inconsistent with it to me

[iuioiua]

Sorry, what are you suggesting? I changed it to jsr:@std/foo@^1. How's that?

[kt3k]

.github/FAQ.md

I wonder this is a right place to document this information. How about adding these sections in "Standard Library" page of deno-docs https://docs.deno.com/runtime/manual/basics/standard_library ?

[iuioiua]

.github/FAQ.md

I wonder this is a right place to document this information. How about adding these sections in "Standard Library" page of deno-docs https://docs.deno.com/runtime/manual/basics/standard_library ?

Almost all information on the Standard Library should be contained within this repo. It doesn't sense to disperse this information elsewhere.

[kt3k]

Almost all information on the Standard Library should be contained within this repo. It doesn't sense to disperse this information elsewhere.

Maybe this topic is out of scope of this PR, but the issue with .github/FAQ.md is that this file doesn't appear anywhere in jsr.io. I think there's high chance that users miss this file.

[kt3k]

LGTM

[iuioiua]

Almost all information on the Standard Library should be contained within this repo. It doesn't sense to disperse this information elsewhere.

Maybe this topic is out of scope of this PR, but the issue with .github/FAQ.md is that this file doesn't appear anywhere in jsr.io. I think there's high chance that users miss this file.

Hopfully, jsr-io/jsr#507 fixes that. I would be happy to discuss it elsewhere.