#redocly — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #redocly, aggregated by home.social.
-
Short video chat with Kin Lane of API evangelist. Read more and catch the video over on his site: https://apievangelist.com/2024/10/17/api-evangelist-conversation-with-lorna-mitchell-vp-of-developer-experience-at-redocly/ -
Short video chat with Kin Lane of API evangelist. Read more and catch the video over on his site: https://apievangelist.com/2024/10/17/api-evangelist-conversation-with-lorna-mitchell-vp-of-developer-experience-at-redocly/ -
Short video chat with Kin Lane of API evangelist. Read more and catch the video over on his site: https://apievangelist.com/2024/10/17/api-evangelist-conversation-with-lorna-mitchell-vp-of-developer-experience-at-redocly/ -
Short video chat with Kin Lane of API evangelist. Read more and catch the video over on his site: https://apievangelist.com/2024/10/17/api-evangelist-conversation-with-lorna-mitchell-vp-of-developer-experience-at-redocly/ -
Short video chat with Kin Lane of API evangelist. Read more and catch the video over on his site: https://apievangelist.com/2024/10/17/api-evangelist-conversation-with-lorna-mitchell-vp-of-developer-experience-at-redocly/ -
🚀 We’ve revamped our API documentation on the help site. It's got all the info to get you started on passbolt's API and the developer guide covers the big-picture stuff.
Shoutout to #Redocly and #Docusaurus for helping us build a sleek, DIY, easy-to-navigate experience.Explore the documentation and let us know what you think! ➡️ https://hubs.li/Q02QgS2k0
-
🚀 We’ve revamped our API documentation on the help site. It's got all the info to get you started on passbolt's API and the developer guide covers the big-picture stuff.
Shoutout to #Redocly and #Docusaurus for helping us build a sleek, DIY, easy-to-navigate experience.Explore the documentation and let us know what you think! ➡️ https://hubs.li/Q02QgS2k0
-
🚀 We’ve revamped our API documentation on the help site. It's got all the info to get you started on passbolt's API and the developer guide covers the big-picture stuff.
Shoutout to #Redocly and #Docusaurus for helping us build a sleek, DIY, easy-to-navigate experience.Explore the documentation and let us know what you think! ➡️ https://hubs.li/Q02QgS2k0
-
🚀 We’ve revamped our API documentation on the help site. It's got all the info to get you started on passbolt's API and the developer guide covers the big-picture stuff.
Shoutout to #Redocly and #Docusaurus for helping us build a sleek, DIY, easy-to-navigate experience.Explore the documentation and let us know what you think! ➡️ https://hubs.li/Q02QgS2k0
-
🚀 We’ve revamped our API documentation on the help site. It's got all the info to get you started on passbolt's API and the developer guide covers the big-picture stuff.
Shoutout to #Redocly and #Docusaurus for helping us build a sleek, DIY, easy-to-navigate experience.Explore the documentation and let us know what you think! ➡️ https://hubs.li/Q02QgS2k0
-
@lornajane
Ended up switching to #redocly for my linting as well - thank your team for such a great tool.Do you happen to know of an example openapi.yaml that throws no errors given the default "recommended" linting rule?
PetStore and PetStore-extended still do. I looked at your planets example as well and it doesn't have 400s, operations summaries, and security defined. This will throw the same errors as the pet store example.
-
@lornajane
Ended up switching to #redocly for my linting as well - thank your team for such a great tool.Do you happen to know of an example openapi.yaml that throws no errors given the default "recommended" linting rule?
PetStore and PetStore-extended still do. I looked at your planets example as well and it doesn't have 400s, operations summaries, and security defined. This will throw the same errors as the pet store example.
-
@lornajane
Ended up switching to #redocly for my linting as well - thank your team for such a great tool.Do you happen to know of an example openapi.yaml that throws no errors given the default "recommended" linting rule?
PetStore and PetStore-extended still do. I looked at your planets example as well and it doesn't have 400s, operations summaries, and security defined. This will throw the same errors as the pet store example.
-
@lornajane
Ended up switching to #redocly for my linting as well - thank your team for such a great tool.Do you happen to know of an example openapi.yaml that throws no errors given the default "recommended" linting rule?
PetStore and PetStore-extended still do. I looked at your planets example as well and it doesn't have 400s, operations summaries, and security defined. This will throw the same errors as the pet store example.
-
@lornajane
Ended up switching to #redocly for my linting as well - thank your team for such a great tool.Do you happen to know of an example openapi.yaml that throws no errors given the default "recommended" linting rule?
PetStore and PetStore-extended still do. I looked at your planets example as well and it doesn't have 400s, operations summaries, and security defined. This will throw the same errors as the pet store example.
-
#MkDocs got a $50 contribution on #OpenCollective recently. The person who made the contribution used a gift card from #Redocly. Anybody has information on these gift cards? I'm very curious 🙂
-
#MkDocs got a $50 contribution on #OpenCollective recently. The person who made the contribution used a gift card from #Redocly. Anybody has information on these gift cards? I'm very curious 🙂
-
#MkDocs got a $50 contribution on #OpenCollective recently. The person who made the contribution used a gift card from #Redocly. Anybody has information on these gift cards? I'm very curious 🙂
-
#MkDocs got a $50 contribution on #OpenCollective recently. The person who made the contribution used a gift card from #Redocly. Anybody has information on these gift cards? I'm very curious 🙂
-
#MkDocs got a $50 contribution on #OpenCollective recently. The person who made the contribution used a gift card from #Redocly. Anybody has information on these gift cards? I'm very curious 🙂
-
I am using the #redocly cli to take my single file JSON to a multi-file JSON. It makes every path into it's own file - this is fine. The problem is if the path has a parameter {x} . Which means it creates a file with the name
"$ref": "paths/users_{id}.json"{ or } is a forbidden character in Linux (and maybe other) filenames. If I change the file name to
"$ref": "paths/users_-id-.json" there is no longer an error.My thought is just to use a script rename the files. You got anything better?
-
I am using the #redocly cli to take my single file JSON to a multi-file JSON. It makes every path into it's own file - this is fine. The problem is if the path has a parameter {x} . Which means it creates a file with the name
"$ref": "paths/users_{id}.json"{ or } is a forbidden character in Linux (and maybe other) filenames. If I change the file name to
"$ref": "paths/users_-id-.json" there is no longer an error.My thought is just to use a script rename the files. You got anything better?
-
I am using the #redocly cli to take my single file JSON to a multi-file JSON. It makes every path into it's own file - this is fine. The problem is if the path has a parameter {x} . Which means it creates a file with the name
"$ref": "paths/users_{id}.json"{ or } is a forbidden character in Linux (and maybe other) filenames. If I change the file name to
"$ref": "paths/users_-id-.json" there is no longer an error.My thought is just to use a script rename the files. You got anything better?
-
I am using the #redocly cli to take my single file JSON to a multi-file JSON. It makes every path into it's own file - this is fine. The problem is if the path has a parameter {x} . Which means it creates a file with the name
"$ref": "paths/users_{id}.json"{ or } is a forbidden character in Linux (and maybe other) filenames. If I change the file name to
"$ref": "paths/users_-id-.json" there is no longer an error.My thought is just to use a script rename the files. You got anything better?
-
I am using the #redocly cli to take my single file JSON to a multi-file JSON. It makes every path into it's own file - this is fine. The problem is if the path has a parameter {x} . Which means it creates a file with the name
"$ref": "paths/users_{id}.json"{ or } is a forbidden character in Linux (and maybe other) filenames. If I change the file name to
"$ref": "paths/users_-id-.json" there is no longer an error.My thought is just to use a script rename the files. You got anything better?
-
Meet Redocly CLI: The Modern OpenAPI Sidekick
https://apisyouwonthate.com/blog/redocly-cli/
"This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been lumbered with trying to maintain: bundling!" -- #PhilSturgeon
-
Meet Redocly CLI: The Modern OpenAPI Sidekick
https://apisyouwonthate.com/blog/redocly-cli/
"This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been lumbered with trying to maintain: bundling!" -- #PhilSturgeon
-
Meet Redocly CLI: The Modern OpenAPI Sidekick
https://apisyouwonthate.com/blog/redocly-cli/
"This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been lumbered with trying to maintain: bundling!" -- #PhilSturgeon
-
Meet Redocly CLI: The Modern OpenAPI Sidekick
https://apisyouwonthate.com/blog/redocly-cli/
"This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been lumbered with trying to maintain: bundling!" -- #PhilSturgeon
-
Meet Redocly CLI: The Modern OpenAPI Sidekick
https://apisyouwonthate.com/blog/redocly-cli/
"This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been lumbered with trying to maintain: bundling!" -- #PhilSturgeon
-
💻 Deprecating a package with 200,000 installs a week feels funny, but I've been waiting for a chance to bin off swagger-cli for ages. It's not being maintained (some upstream dependencies are which helps) but even the name is out of date. Thankfully the #Redocly CLI does everything it did, but better, so I recommend you go use that.
More deprecations of old #OpenAPI tooling to come as I find more viable modern alternatives.
#APIDesign #APIDevelopment #OpenSource
https://www.npmjs.com/package/@redocly/cli -
💻 Deprecating a package with 200,000 installs a week feels funny, but I've been waiting for a chance to bin off swagger-cli for ages. It's not being maintained (some upstream dependencies are which helps) but even the name is out of date. Thankfully the #Redocly CLI does everything it did, but better, so I recommend you go use that.
More deprecations of old #OpenAPI tooling to come as I find more viable modern alternatives.
#APIDesign #APIDevelopment #OpenSource
https://www.npmjs.com/package/@redocly/cli -
💻 Deprecating a package with 200,000 installs a week feels funny, but I've been waiting for a chance to bin off swagger-cli for ages. It's not being maintained (some upstream dependencies are which helps) but even the name is out of date. Thankfully the #Redocly CLI does everything it did, but better, so I recommend you go use that.
More deprecations of old #OpenAPI tooling to come as I find more viable modern alternatives.
#APIDesign #APIDevelopment #OpenSource
https://www.npmjs.com/package/@redocly/cli -
💻 Deprecating a package with 200,000 installs a week feels funny, but I've been waiting for a chance to bin off swagger-cli for ages. It's not being maintained (some upstream dependencies are which helps) but even the name is out of date. Thankfully the #Redocly CLI does everything it did, but better, so I recommend you go use that.
More deprecations of old #OpenAPI tooling to come as I find more viable modern alternatives.
#APIDesign #APIDevelopment #OpenSource
https://www.npmjs.com/package/@redocly/cli -
💻 Deprecating a package with 200,000 installs a week feels funny, but I've been waiting for a chance to bin off swagger-cli for ages. It's not being maintained (some upstream dependencies are which helps) but even the name is out of date. Thankfully the #Redocly CLI does everything it did, but better, so I recommend you go use that.
More deprecations of old #OpenAPI tooling to come as I find more viable modern alternatives.
#APIDesign #APIDevelopment #OpenSource
https://www.npmjs.com/package/@redocly/cli -
💻 Woah, I'm reviewing #Redocly CLI and I just noticed the amazing split command!
$ redocly split api/openapi.yaml --outDir output/
This will neatly split a sprawling messy #OpenAPI description into multiple documents using $ref, reducing duplication, making it easier to work with.
-
💻 Woah, I'm reviewing #Redocly CLI and I just noticed the amazing split command!
$ redocly split api/openapi.yaml --outDir output/
This will neatly split a sprawling messy #OpenAPI description into multiple documents using $ref, reducing duplication, making it easier to work with.
-
💻 Woah, I'm reviewing #Redocly CLI and I just noticed the amazing split command!
$ redocly split api/openapi.yaml --outDir output/
This will neatly split a sprawling messy #OpenAPI description into multiple documents using $ref, reducing duplication, making it easier to work with.
-
💻 Woah, I'm reviewing #Redocly CLI and I just noticed the amazing split command!
$ redocly split api/openapi.yaml --outDir output/
This will neatly split a sprawling messy #OpenAPI description into multiple documents using $ref, reducing duplication, making it easier to work with.
-
💻 Woah, I'm reviewing #Redocly CLI and I just noticed the amazing split command!
$ redocly split api/openapi.yaml --outDir output/
This will neatly split a sprawling messy #OpenAPI description into multiple documents using $ref, reducing duplication, making it easier to work with.
