5 ms·

As there's a theme in comments here - I'm surprised people are so confused by the landing page. Between "a linter for prose" and the screenshot at the top of th

As there's a theme in comments here - I'm surprised people are so confused by the landing page. Between "a linter for prose" and the screenshot at the top of the page, I found it quite clear what the use case and point of the tool was. Personally interested where the confusion is- maybe unfamiliarity with "linting" or "prose"?

hhh 3y ago
I found it clear when I looked at the site, but never thought about prose being used in this way. I didn't know the actual definition though, and after googling it's clear.
dmarchand90 3y ago
I think it's the lack of examples. Also, because this is very cutting edge, I'd like to know a bit of the technology behind it to know the strengths and limits. E.g. is it based on hard Coded grammar and thus a bit stiff and dumb? Or is it llm based and therefore with data control issues? It would also be nice to see examples of what it can do. Again, if it's hard Coded grammar it would be nice to see the complexity it can handle, if llm, the lengths the token limits can manage
playingalong 3y ago
The name linter is not widespread in its use as some think. In some ecosystems it's just called "static analysis tools" or something. I came to learn the tool "linter" after having exposure to a few tools of this kind, several years into the programming career.
layer8 3y ago
It’s the lack of examples (I actually browsed the site for 2–3 minutes for some and didn’t find any), and that the screenshot doesn’t show the input prose text that the output applies to. Instead of the long list of integrations, more exposition and context would be helpful, or at least an immediate link to an introduction page providing that. In earlier times, software documentation would provide a whole introductory book chapter providing the context, use cases, and some examples. As a side note, regarding the screenshot, I’m wondering whether the tool also provides a rationale for each item, as the displayed text isn’t very informational on the why.
jonahx 3y ago
I didn't think it was bad but there were some points of confusion that could be improved: 1. "Your style, our editor" Wait is this an editor or a command line tool? I was able to figure it out but the word "editor" is ambiguous here. 2. "that brings your editorial style guide to life." Ok, so do I have to write all my own rules? Or is it like eslint where I choose a base config with ability to override, and possibly add more? These questions are so fundamental I would like to see succint answers at least hinted at in another tag line or short paragraph, even if I can figure them out by digging into the docs.
deleted 3y ago
[deleted]
alpaca128 3y ago
> Personally interested where the confusion is There is no clear explanation of what it actually is, just a vague sentence saying "brings your editorial style guide to life" which can mean a lot of things. And the screenshot is a wall of text in the smallest font size across the entire page (even smaller than the labels of the logos that make up 50% of the area), so if it was intended as carrier of important information it wasn't the right choice. The HN post title says more in four words than the entire landing page.

hhh 3y ago

I found it clear when I looked at the site, but never thought about prose being used in this way. I didn't know the actual definition though, and after googling it's clear.

dmarchand90 3y ago

I think it's the lack of examples. Also, because this is very cutting edge, I'd like to know a bit of the technology behind it to know the strengths and limits. E.g. is it based on hard Coded grammar and thus a bit stiff and dumb? Or is it llm based and therefore with data control issues? It would also be nice to see examples of what it can do. Again, if it's hard Coded grammar it would be nice to see the complexity it can handle, if llm, the lengths the token limits can manage

playingalong 3y ago

The name linter is not widespread in its use as some think. In some ecosystems it's just called "static analysis tools" or something. I came to learn the tool "linter" after having exposure to a few tools of this kind, several years into the programming career.

layer8 3y ago

It’s the lack of examples (I actually browsed the site for 2–3 minutes for some and didn’t find any), and that the screenshot doesn’t show the input prose text that the output applies to. Instead of the long list of integrations, more exposition and context would be helpful, or at least an immediate link to an introduction page providing that. In earlier times, software documentation would provide a whole introductory book chapter providing the context, use cases, and some examples. As a side note, regarding the screenshot, I’m wondering whether the tool also provides a rationale for each item, as the displayed text isn’t very informational on the why.

jonahx 3y ago

I didn't think it was bad but there were some points of confusion that could be improved: 1. "Your style, our editor" Wait is this an editor or a command line tool? I was able to figure it out but the word "editor" is ambiguous here. 2. "that brings your editorial style guide to life." Ok, so do I have to write all my own rules? Or is it like eslint where I choose a base config with ability to override, and possibly add more? These questions are so fundamental I would like to see succint answers at least hinted at in another tag line or short paragraph, even if I can figure them out by digging into the docs.

deleted 3y ago

[deleted]

alpaca128 3y ago

> Personally interested where the confusion is There is no clear explanation of what it actually is, just a vague sentence saying "brings your editorial style guide to life" which can mean a lot of things. And the screenshot is a wall of text in the smallest font size across the entire page (even smaller than the labels of the logos that make up 50% of the area), so if it was intended as carrier of important information it wasn't the right choice. The HN post title says more in four words than the entire landing page.