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