tools: remove redundant code in doc/html.js

[vsemozhetbyt]

Checklist

• make -j4 test (UNIX), or vcbuild test (Windows) passes
• commit message follows commit guidelines

Status quo

Currently, parseLists() function in tools/doc/html.js has some flaws:

1. It tries to add <div class="signature">...</div> elements around lists of signature types (function parameters, returned values, property types). However, we have no such class in our api_assets\style.css, so this wrapping list blocks in DIV blocks is redundant.
2. Due to a logic error, only lists without YAML blocks between heading and list are wrapped. This produces mostly false-positive and false-negative results (most signature lists are not wrapped, many non-signature lists are wrapped).
3. Logic scaffolding for this wrapping overcomplicates this function.
4. Processing of YAML blocks depends on unneeded restriction: only YAML blocks straight after heading are processed (currently, it seems we have no other ones, but we may have others in future).

Fixing strategy

1. Remove redundant DIV wrapping for lists.
2. Remove connected logic scaffolding.
3. Process all YAML blocks regardless of their place.
4. Simplify overall logic for remaining function code.
5. Reorder conditional blocks to reflect processed source structure.
6. Update comment and function name to describe function destination more correctly.
7. Update test.

This PR reduces code by 40 lines and docs size by ~7.5 KB. Only <div class="signature">...</div> wrappers are removed from docs, no other changes are found in results.

The visible styles of wrapped and unwrapped lists are identical:

cc @nodejs/documentation

[vsemozhetbyt]

Node.js Collaborators, please, add 👍 here if you approve fast-tracking.

[vsemozhetbyt]

CI-lite: https://ci.nodejs.org/job/node-test-pull-request-lite/667/

[BridgeAR]

RSLGTM

[BridgeAR]

@vsemozhetbyt I am really glad you look into these things and improve our docs tooling! 👍

[vsemozhetbyt]

@BridgeAR Thank you!

[tniessen]

Glad to see changes which reduce the size of our codebase!

[trivikr]

RSLGTM

[apapirovski]

Landed in 974df9c. Thanks @vsemozhetbyt!