deutrino
I'm trying to find docs on the federation API for Masto et al. Mistake #1, I know. Anyway I found a GNUsocial plugin somebody is writing; the API is specified in JSON using a standard called #OpenAPI 3.
Great, I think, surely there's a web tool to generate docs from this definition. Lo, there are several! All written with hip JS frameworks du jour.
Not a single fucking ONE of them can produce an intelligible printout, nor save intelligible HTML. Not one.
deutrino
...and NONE of the people who've written an #OpenAPI documentation rendering tool can be bothered to ship a package for it.
(Except a node package. Some of them can ship those. By god, I've made it to late 2018 without installing an ENTIRE DEVELOPMENT ECOSYSTEM to run somebody's stupid tool, I'm not about to start now.)
((I'm just going to pretty-print the JSON and dump it in my issue tracker and call it good, no thanks to any of these helpful tools.))
Jonkman Microblog is a social network, courtesy of SOBAC Microcomputer Services. It runs on GNU social, version 1.2.0-beta5, available under the GNU Affero General Public License.
All Jonkman Microblog content and data are available under the Creative Commons Attribution 3.0 license.