More documentation updates for 3.11.0

[falbrechtskirchinger]

mkdocs

• Add string_view examples.
• Add operator<=> examples.
• Rename some examples, following a consistent scheme: <function> _ _ <parameter type> [_ const]
• Fix some style check issues: missing admonition titles, line length, missing sections, ...
• Review BJData page and edit slightly.
• Add CMake option hint to macro pages.

docset

• Add/update all macros with up-to-date URLs.
• Add missing operators and mirror order from mkdocs.
• Other additions: object_comparator_t, BJData, "Arbitrary Type Conversions", ...
• Add list_missing_pages make target. Prints the list of mkdocs pages missing from the docset index.
• Add list_removed_paths make target. Prints the list of paths in the docset index without a matching mkdocs page.
• Add install_docset_zeal make target (https://zealdocs.org/). (That's the documentation browser I'm using.)

To Do

• Fix JSON_DISABLE_ENUM_SERIALIZATION Default definition section.
• Rename docset methods.
• Update stream operators in docset index.
• Add missing pages to docset index.
• Fix link to unit-udt.cpp https://json.nlohmann.me/features/arbitrary_types/#how-can-i-use-get-for-non-default-constructiblenon-copyable-types
• Check links to the repository after folder renames.

[coveralls]

Coverage remained the same at 100.0% when pulling 3cb9731 on falbrechtskirchinger:documentation into 11ba5c1 on nlohmann:develop.

[falbrechtskirchinger]

The test timeout issue is not fixed and, thanks to the debug commit, I understand why. I thought I was being clever by resetting the test timeout based on the xxxx of yyyy UTF-8 strings checked output – turns out, that the CMake test property TIMEOUT_AFTER_MATCH is only applied once. Guess I'll add another mini-PR to the pile, that just raises the TIMEOUT property to … twice the default.

[falbrechtskirchinger]

@nlohmann This PR depends on #3590 (mkdocs-redirects) and needs a few more changes (docset index, redirects map), but is otherwise done.

[nlohmann]

@nlohmann This PR depends on #3590 (mkdocs-redirects) and needs a few more changes (docset index, redirects map), but is otherwise done.

#3590 is merged now.

[falbrechtskirchinger]

I'll double-check things tomorrow but I believe this one's complete now. docset should be on par with mkdocs.

[nlohmann]

Sigh - we need some mechanism to compile some examples with higher C++ versions. Quick idea: encode the version in the file name.

[falbrechtskirchinger]

Yeah, I don't have a better idea for now. On it (after I grab some coffee :-)).

[falbrechtskirchinger]

For the record:

mkdocs: move string literals bbcf4c1

[falbrechtskirchinger]

Undo.

[falbrechtskirchinger]

Nope. This line has to go. clean removes docSet.dsidx.

[nlohmann]

Looks good to me.

[falbrechtskirchinger]

Hold. Hold. Hold.

Checking on one last issue.

[falbrechtskirchinger]

All good.