7 ms·

I mean this nicely, I don't really feel like anything on the landing page besides one paragraph is actually helpful to readers understanding what problem you're

I mean this nicely, I don't really feel like anything on the landing page besides one paragraph is actually helpful to readers understanding what problem you're trying to solve. I think it'd be useful to focus on this more: > Voiden turns your API definitions and docs into dynamic, purpose-built interfaces — no fixed UI, no rigid templates. Everything is composed in one place and rendered down to Markdown, tailored to the API it serves.

nikolasdimi 1y ago
true
kiselitza 1y ago
Hmm, I appreciate this, for real. We'll have some more discussions on how to optimize the landing page. Curious, how do you feel about the tagline stuff? Happy to learn anything else you'd be willing to add here. We're all for making it crystal clear, no fluff, just making devs lives easier, which also means not wasting their time to understand whether they need it or not.
- qcic 1y ago
  Not GP, but the tagline above the fold doesn’t tell anything related to the actual value prop. Modular, extensions etc are implementation details. Git-native? I had an “idea” of what that meant, but had to scroll down to confirm.
  - andybak 1y ago
    I'm still not sure what an "API client" is in this context.
    - lawgimenez 1y ago
      Or git-native means.
      - andybak 1y ago
        I just downloaded it and tried it and I still don't understand what it does. It seems to be some kind of wysiwyg editor? With elements specific to API docs? But then why does that make it an "API client". I'm guessing "API" specifically means HTTP API here. But "client" is completely throwing me. An API client is just software that talks to an API. So what's with the wysiwyg stuff? Is it something like Jupyter notebooks?
        kiselitza 1y ago
        The Jupyter comparison isn't completely off base if you'd like to rationalise it that way. Similarity would be blending the code and the docs in a single file, where you can then also execute something. By definition, API Client is a devtool that makes it easier for devs (& co.) to design, test, document, and debug APIs. If it's confusing, we can take it to Postman, but it's an industry standard, been that way for a long while.
        andybak 1y ago
        > By definition, API Client is a devtool that makes it easier for devs (& co.) to design, test, document, and debug APIs. If it's confusing, we can take it to Postman, but it's an industry standard, been that way for a long while. That's not the definition of "API client" I'm familiar with. In fact it feels like a very specific definition of "API client" - which is a broad term that I am familiar with. (Why does it sometimes feel like I am not getting the memos that everyone else is getting? It's like when a new job description for an old job suddenly appears and everyone pretends that what it's always been called!)
        kiselitza 1y ago
        Maybe you thought of an SDK-like client/wrapper for calling certain APIs, so it sounds natural to call it an API client? Here you can check a list of currently OSS API clients (competitors to Voiden - the tool I posted about) https://github.com/stepci/awesome-api-clients https://github.com/stepci/awesome-api-clients Will join the list soon after we go OSS too. :)
    - kiselitza 1y ago
      Not sure how else to reply to this one, but it is the same thing as in its definition. Think less of client-server, think more of Postman, but without gazillion tabs and with docs at the same place with your API endpoint definition, headers, body, etc.

nikolasdimi 1y ago

true

kiselitza 1y ago

Hmm, I appreciate this, for real. We'll have some more discussions on how to optimize the landing page. Curious, how do you feel about the tagline stuff? Happy to learn anything else you'd be willing to add here. We're all for making it crystal clear, no fluff, just making devs lives easier, which also means not wasting their time to understand whether they need it or not.

qcic 1y ago
Not GP, but the tagline above the fold doesn’t tell anything related to the actual value prop. Modular, extensions etc are implementation details. Git-native? I had an “idea” of what that meant, but had to scroll down to confirm.
- andybak 1y ago
  I'm still not sure what an "API client" is in this context.
  - lawgimenez 1y ago
    Or git-native means.
    - andybak 1y ago
      I just downloaded it and tried it and I still don't understand what it does. It seems to be some kind of wysiwyg editor? With elements specific to API docs? But then why does that make it an "API client". I'm guessing "API" specifically means HTTP API here. But "client" is completely throwing me. An API client is just software that talks to an API. So what's with the wysiwyg stuff? Is it something like Jupyter notebooks?
      - kiselitza 1y ago
        The Jupyter comparison isn't completely off base if you'd like to rationalise it that way. Similarity would be blending the code and the docs in a single file, where you can then also execute something. By definition, API Client is a devtool that makes it easier for devs (& co.) to design, test, document, and debug APIs. If it's confusing, we can take it to Postman, but it's an industry standard, been that way for a long while.
        andybak 1y ago
        > By definition, API Client is a devtool that makes it easier for devs (& co.) to design, test, document, and debug APIs. If it's confusing, we can take it to Postman, but it's an industry standard, been that way for a long while. That's not the definition of "API client" I'm familiar with. In fact it feels like a very specific definition of "API client" - which is a broad term that I am familiar with. (Why does it sometimes feel like I am not getting the memos that everyone else is getting? It's like when a new job description for an old job suddenly appears and everyone pretends that what it's always been called!)
        kiselitza 1y ago
        Maybe you thought of an SDK-like client/wrapper for calling certain APIs, so it sounds natural to call it an API client? Here you can check a list of currently OSS API clients (competitors to Voiden - the tool I posted about) https://github.com/stepci/awesome-api-clients https://github.com/stepci/awesome-api-clients Will join the list soon after we go OSS too. :)
  - kiselitza 1y ago
    Not sure how else to reply to this one, but it is the same thing as in its definition. Think less of client-server, think more of Postman, but without gazillion tabs and with docs at the same place with your API endpoint definition, headers, body, etc.