doc: spruce up user journey to local docs browsing

[DerekNonGeneric]

This patch improves the means by which the docs are viewed locally.

• Remove extraneous code in the docserve Makefile target
• Document the docserve task for all to know
• Bring all code snippets in this section up to speed
• Clarify the purpose of each documentation browsing method

Fixes: #34977

[DerekNonGeneric]

Welp, not much of a diff anymore in light of #34977 (comment), but this does indeed work on my machine for some reason and speculate that it's due to having run ./configure beforehand, which was able to identify my correct Python version.

[richardlau]

configure will write the detected Python into config.mk, which is included in the Makefile

node/Makefile

Line 1 in e1edd6b

-include config.mk

[codecov-commenter]

Codecov Report

Merging #34986 into master will increase coverage by 0.01%.
The diff coverage is 89.00%.

@@            Coverage Diff             @@
##           master   #34986      +/-   ##
==========================================
+ Coverage   96.67%   96.69%   +0.01%     
==========================================
  Files         208      207       -1     
  Lines       68993    69126     +133     
==========================================
+ Hits        66701    66841     +140     
+ Misses       2292     2285       -7     

Impacted Files	Coverage Δ
lib/internal/errors.js	97.97% <50.00%> (+0.13%)	⬆️
lib/internal/modules/esm/resolve.js	94.53% <80.00%> (+<0.01%)	⬆️
lib/internal/policy/manifest.js	86.53% <87.66%> (+8.13%)	⬆️
lib/internal/modules/cjs/loader.js	94.71% <90.90%> (+<0.01%)	⬆️
lib/perf_hooks.js	96.00% <94.11%> (+0.04%)	⬆️
lib/_stream_readable.js	99.01% <100.00%> (+<0.01%)	⬆️
lib/internal/modules/esm/get_source.js	90.47% <100.00%> (+5.11%)	⬆️
lib/internal/modules/package_json_reader.js	100.00% <100.00%> (ø)
lib/internal/process/execution.js	98.09% <100.00%> (-0.07%)	⬇️
lib/net.js	95.29% <100.00%> (-0.01%)	⬇️
... and 4 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update a1faa8d...94b75aa. Read the comment docs.

[DerekNonGeneric]

@mmarchini, I've clarified the prose a bit, PTAL.

[DerekNonGeneric]

There's still some sort of a bug here. It's not working as I would expect. I should be able to run:

make docclean
make docserve

However, instead, I get this error:

Error: ENOENT: no such file or directory, open 'out/doc/apilinks.json'
    at Object.openSync (fs.js:457:3)
    at Object.writeFileSync (fs.js:1282:35)
    at Object.<anonymous> (/mnt/c/orgs/nodejs/node-runtime/tools/doc/apilinks.js:211:4)
    at Module._compile (internal/modules/cjs/loader.js:1157:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1177:10)
    at Module.load (internal/modules/cjs/loader.js:1001:32)
    at Function.Module._load (internal/modules/cjs/loader.js:900:14)
    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:74:12)
    at internal/main/run_main_module.js:18:47 {
  errno: -2,
  syscall: 'open',
  code: 'ENOENT',
  path: 'out/doc/apilinks.json'
}

This is evidence that #34986 (comment) needs to be addressed first.

[DerekNonGeneric]

Landed in ff0aad0