Misc #14581: Update JSON docs

• Status: Third Party's Issue
• Assignee: -

[zverok (Victor Shepelev)]

What is here:

• adding docs for (questionable, yet present) "additions" feature;
• cleaning up (both formatting and formulations) docs of JSON.generate: current docs are poorly formatted and its documentation shifted more towards (internal) State object than just options;
• some other style/formatting cleanups.

[zverok (Victor Shepelev)]

• Description updated (diff)

[hsbt (Hiroshi SHIBATA)]

• Status changed from Open to Third Party's Issue

Can you submit an upstream repository first?

https://github.com/flori/json

[zverok (Victor Shepelev)]

@hsbt (Hiroshi SHIBATA) Ah, OK. I've tried to find the "upstream" version but failed to do so. Thanks for pointing it out.

[zverok (Victor Shepelev)]

@hsbt (Hiroshi SHIBATA) BTW, what's the maintenance status of the upstream? Currently, I can see there:

• the last PR is merged in October, last before that in Jun, last before that in spring, there are several uncommented PRs (including ones with serious performance improvements, or security issue discussion/PR open for 3 years in a row)
• there are a lot of unaddressed issues, and of closed ones, the last that was touched by repo owner was just silent closing (of irrelevant ones?) in April

I was thinking about doing several PRs to clean up the legacy parts of the library & docs, but now I am not sure if there would be anybody on the receiving end of those PRs.

[zverok (Victor Shepelev)]

(In addition, as far as I understand, there is some discrepancy between "standalone" json and in-Ruby json: the latter does not include "pure" part of JSON library, virtually rendering half of its code and docs false.)

[hsbt (Hiroshi SHIBATA)]

what's the maintenance status of the upstream?

It's active.

[zverok (Victor Shepelev)]

@hsbt (Hiroshi SHIBATA)

what's the maintenance status of the upstream?

It's active.

I just noticed my documentation patches #349 and #347 and clarification request #348 are pending since March 2018, e.g. for 1.5 years already. Is there something that can be done to unfreeze them?..