News for hackers. Stuff that matters.
Re:Writing like a pro with Vale and Neovim by ComputerGuru on Friday June 17, 2022 @01:29PM (#31781470)
The answer to writing better isn’t a “static code completion/linting tool, but for English.”

Leave it to the tech industry to really exemplify the “when all you have is a hammer…” mentality.

Re:Writing like a pro with Vale and Neovim by d0mine on Friday June 17, 2022 @01:52PM (#31781804)
Any activity has boring aspects. Using the tool to automate such things should be encouraged.

Obviously, linters can produce many false positives--they shouldn't be used blindly.

Re:Writing like a pro with Vale and Neovim by rojobuffalo on Friday June 17, 2022 @03:26PM (#31783093)
boredom is useful to a writer. a lot of my favorite writers have mentioned writing all first drafts with pen and paper. what happens in your brain when you're writing is important, even when it feels boring, slow, or repetitive. who has a better sense of where my attention should be, me or a tool? imo better writing is the product of practice, reading, and better thinking. all of that to say, if you have a pre-publishing step where you need to check spelling, grammar, capitalization, punctuation, etc. a linter might fit in at that step. but i really don't think a tool is better than your own reading or giving it to an editor you trust.
Re:Writing like a pro with Vale and Neovim by Jolter on Friday June 17, 2022 @05:40PM (#31784727)
Nice post contents, but is your shift key broken or something?
Re:Writing like a pro with Vale and Neovim by giraffe_lady on Friday June 17, 2022 @10:16PM (#31786768)
you volunteering to do our mechanical editing now?
Re:Writing like a pro with Vale and Neovim by BeFlatXIII on Saturday June 18, 2022 @11:00AM (#31790378)
In addition to the false positives, automated linters pick up on the little errors that blow right past manual review. It's no substitute for human editing for content, but it is better for nitpicking and cleanup.
Re:Writing like a pro with Vale and Neovim by ComputerGuru on Friday June 17, 2022 @02:04PM (#31781997)
I can see where you’re coming from but I don’t believe something like Vale will - in practice, not in theory - actually do that. You would need a general purpose AI to pull that off, otherwise domain-specific, bespoke, one-off tools (eg to transform an API into a documentation template, to make skeleton release notes out of git/GitHub/Jira/whatever records, etc) combined with a two-hour crash course on effective writing are probably the way to go.

But obviously enough people disagree that this is a thing.. although that could be said for quite a number of “technical progress” milestones we currently celebrate.

Re:Writing like a pro with Vale and Neovim by vorpalhex on Friday June 17, 2022 @02:42PM (#31782532)
Sometimes tools that seem to help us make us more reckless.

I wonder if tools like grammarly have this problem..

Re:Writing like a pro with Vale and Neovim by beepbooptheory on Friday June 17, 2022 @07:24PM (#31785773)
When people talk about "writing" on here, they typically referring to the kind of prose that benefits from stuff like this: technical, aiming to be informative, and adhere to industry standards or conventions. Not to mention the fact that this is industry with a lot of ESL writers.

They aren't, typically, talking about the kind of stuff that you work on in a creative writing elective you take one semester. The very same class, in fact, that gave you this presumptuousness.

Re:Writing like a pro with Vale and Neovim by hsbauauvhabzb on Friday June 17, 2022 @02:10PM (#31782067)
You don’t use any kind of spellcheck / grammar checks on documents?
Re:Writing like a pro with Vale and Neovim by ComputerGuru on Friday June 17, 2022 @02:12PM (#31782098)
That’s hardly the raison d’être of Vale and co, and that’s arguably replacing (quite poorly!) the job of an editor not the writer.
Re:Writing like a pro with Vale and Neovim by stingraycharles on Friday June 17, 2022 @02:16PM (#31782174)
Most people that write content, even more so the target audience of this post, don’t have a editor (other than the software editor).
Re:Writing like a pro with Vale and Neovim by vorpalhex on Friday June 17, 2022 @02:41PM (#31782522)
Please use editors.

I typically get two different people to edit my blog posts...

Re:Writing like a pro with Vale and Neovim by toma_caliente on Friday June 17, 2022 @02:59PM (#31782756)
As someone considering starting a casual blog, I would not use an editor and defintiely not editors. Seems like a weird gate to keep.
Re:Writing like a pro with Vale and Neovim by vorpalhex on Friday June 17, 2022 @03:20PM (#31783021)
One misspelling, mixed metaphor, missing contraction.

Nobody writes flawlessly. It is hard to find your own mistakes, much less understand if content will make sense to someone else.

An editor is someone who can read your work, help catch errors and suggest improvements.

No you don't need to go pay someone, but either trade editing with a friend or find another way to compensate whoever is providing editing for you. I usually buy my editors dinner but adjust based on how much time investment you are asking of them.

Re:Writing like a pro with Vale and Neovim by cestith on Friday June 17, 2022 @04:13PM (#31783650)
I see a typo.

You do not get to choose when a writer uses a contraction. You might expect that I'd have used "don't" there, but the simple truth is people use the full words even conversationally sometimes. This is especially true when they want to emphasize the "not" part of a phrase like "will not", "would not", or "do not". Your suggested edit changes the meaning of the parent post a shade.

Where's the mixed metaphor? You may be able to sell me on "weird gate to keep" being a trite metaphor or perhaps even an awkward metaphor. What's mixed about gatekeeping, which seems to be a single common metaphor?

If this is the quality of editing the tool offers, one may wish to stick with spellcheck. Encouraging a particular organization's writing style within that organization can have some nice effects, but you don't get to determine everyone else's writing style.

Re:Writing like a pro with Vale and Neovim by corrral on Friday June 17, 2022 @03:08PM (#31782883)
Editors are expensive and publishers don't really provide that service to authors, anymore. You're expected to have that all taken care of before you submit, even to publications that barely pay (or even some that don't pay at all).
Re:Writing like a pro with Vale and Neovim by leephillips on Friday June 17, 2022 @03:39PM (#31783238)
I make most of my income from writing. My experience is the opposite of this.

https://lee-phillips.org/whypay/

Re:Writing like a pro with Vale and Neovim by corrral on Friday June 17, 2022 @04:03PM (#31783528)
Page is blank for me and I couldn't find a version though your site's search.

Your experience is that editors are cheap and that publishers readily supply substantial editing services, not requiring that practically all editing work is done before entertaining a submission? That's contrary to the experience of multiple close friends and relatives who are writers or are working on getting published, and to that of multiple others I follow whose experiences I've heard or read about.

Re:Writing like a pro with Vale and Neovim by leephillips on Friday June 17, 2022 @04:20PM (#31783755)
Sorry about that. I don’t know how it happened, but it’s fixed now.

I don’t know what you mean by editors being cheap. I don’t pay them, they’re employees of the publications I write for. I assume they’re underpaid, of course.

My first draft is better than the finished product you’ll find in most publications (not bragging, it’s just the truth). Before it’s published, however, it goes through several rounds of editing with from one to three editors, and a technical review. This can last weeks. I may have to generate five revisions before it’s good enough. It could be that your acquaintances are writing for publications with lower standards.

EDIT: By the way, if you have friends who are submitting to publications that don’t pay, or pay only a token amount, please suggest to them that they stop. This depresses the market for writers who are tying to make a living with it. Don’t fall for the “exposure” gambit or give away your stuff to feed your ego. You‘re being robbed.

Re:Writing like a pro with Vale and Neovim by corrral on Friday June 17, 2022 @04:34PM (#31783964)
> Sorry about that. I don’t know how it happened, but it’s fixed now.

No problem, shit happens.

> My first draft is better than the finished product you’ll find in most publications (not bragging, it’s just the truth). Before it’s published, however, it goes through several rounds of editing with from one to three editors, and a technical review. This can last weeks. I may have to generate five revisions before it’s good enough. It could be that your acquaintances are writing for publications with lower standards.

Premier genre periodicals, as no other short fiction venues pay worth a damn, these days. Novels through trad publishing—the ones I know who self-publish barely edit at all and certainly don't pay for editors, which is, judging from the quality of the median self-published work, evidently the norm in that world. Household-name monthlies, with non-fiction writing, in those cases, though some of those publications do also print fiction.

The ones I know who publish longer-form non-fiction writing do seem to get somewhat more support from their publishers, to be fair, but most of the editing work does still need to be done before submission or you're getting round-filed. Those also tend to be more well-defined and goal-oriented pieces, so content editing is less necessary or extensive.

What most will do, at least, is tell you what to cut if they need the piece to be shorter.

[EDIT]

> EDIT: By the way, if you have friends who are submitting to publications that don’t pay, or pay only a token amount, please suggest to them that they stop. This depresses the market for writers who are tying to make a living with it. Don’t fall for the “exposure” gambit or give away your stuff to feed your ego. You‘re being robbed.

Oh don't worry, they're all pretty allergic to that. Good warning though, and worth mentioning. The lit-fic market especially is a complete joke in this regard. But I suppose it's hard to blame publishers when they have such a glut of people willing to put words to paper for little or no compensation.

Re:Writing like a pro with Vale and Neovim by leephillips on Friday June 17, 2022 @04:41PM (#31784054)
Hmm. I had in mind non-fiction, as we were discussing editing. I can't imagine a fiction writer wanting his or her creations to be touched by an editor. But I accept your report that such people exist.
Re:Writing like a pro with Vale and Neovim by halostatue on Friday June 17, 2022 @06:08PM (#31785036)
A lot of fiction writers don’t, but desperately need such editing.

I’ve read plenty of books that could have told the story in 20% fewer pages, or had a swapped character name, or…

Some of these passed through multiple layers of editing. Some of these "passed" through those layers because the writer got too famous or cantankerous or…

I acted as one of my wife’s editors for her books, and some of the things that I checked (as it was recent historical fiction) included whether the weather she described for a chapter matched the weather reported by Environment Canada. She had one scene in early April of a year where she said that the "last of the snows had gone…", but there was a snowstorm on the 3rd of April or something like that. As the weather was not critical to the scene, I insisted that it either be dropped or changed (she changed it) — because getting that sort of item wrong can throw a reader out of the flow of the book.

In another instance in her second book, she had a weather condition that was crucial to the plot. We looked to see that it would be plausible (e.g., it was not 50℃ in February in Toronto in 1979), then let the weather condition stand because it mattered.

Re:Writing like a pro with Vale and Neovim by vorpalhex on Friday June 17, 2022 @04:02PM (#31783514)
As a heads up, this is not loading for me. Your other pages seem fine, and I'm not getting a 404, just an empty page. Doesn't seem to be adblock or pihole.
Re:Writing like a pro with Vale and Neovim by leephillips on Friday June 17, 2022 @04:15PM (#31783677)
Thanks for the heads up. It’s fixed now.
Re:Writing like a pro with Vale and Neovim by vorpalhex on Friday June 17, 2022 @03:22PM (#31783041)
Editors are expensive. There's also a reason most publishers who have stopped using them have experienced a major decline.

Skilled labor is expensive. Editors are skilled labor. Those who use them will benefit from that labor.

Re:Writing like a pro with Vale and Neovim by corrral on Friday June 17, 2022 @04:05PM (#31783546)
Yes, editors are wonderful and ought to be paid well (even if authors aren't...) but authors who can't afford editors (i.e. all the ones trying to break in to writing but who don't have substantial financial backing) benefit greatly from tools that help them do their own editing more efficiently.
Re:Writing like a pro with Vale and Neovim by leephillips on Friday June 17, 2022 @04:30PM (#31783879)
I don’t believe it (but am willing to consider actual evidence, if any exists). Spellcheckers, sure. But until we get an actual AI with general intelligence and cultural awareness sufficient to understand the nuances of human language, even “grammar checking” can not be mechanized.

Really, anyone considering working as an author who can’t produce an excellent, polished first draft without an editor should consider a line of work more attuned to his or her talents.

Re:Writing like a pro with Vale and Neovim by vorpalhex on Friday June 17, 2022 @05:56PM (#31784913)
> Really, anyone considering working as an author who can’t produce an excellent, polished first draft without an editor should consider a line of work more attuned to his or her talents.

Really, anyone considering being a programmer who can't write a program without bugs on the first try without an IDE should...

Yeah that seems overly harsh and incorrect. Skills take time and practice to develop.

Re:Writing like a pro with Vale and Neovim by corrral on Friday June 17, 2022 @05:09PM (#31784407)
Sure, maybe, but the better automated tools get, the higher standards will be before submissions are considered. I bet slush-pile readers were a lot more tolerant of the occasional tranpsosed letter before spell check existed, for instance. Now if there's even one misspelling in a piece it looks like you're not trying at all, since you should have seen the red-squiggle, and into the rejections you go. So it will become (already is becoming) for brevity, clear wording, avoiding repetition, et c.

If tools save time or reduce the technical skill required, that seems great to me. Art's about the finished product, not how it gets there, though popular understanding of how artists work and how they actually work may differ substantially. Almost no authors can always recall the exact word they want, the precise wording of that phrase they want to quote, the rule for some particular piece of grammar, and so on—they may have a whole shelf of Brewer's and Roget's and Webster's and Garner's and Strunk & White for that, plus computerized tools, these days. Why not have tools for the other aspects of editing? Why not have a computer find a suggestion for you, before you even think to consult a source or scrutinize a passage more closely?

Plus, I guess I don't care much about any sort of purity in the writing process since practically the only accepted style, these days, in English writing at any rate, is fairly rote and prescribed and very simple. Did that sentence seem too complex? Did it have too many clauses? Does your inner editor's voice pipe up while reading it? Yep, exactly—it violates that very-modern style, even if only a bit. May as well take the next step and let a machine enforce those rules.

More generally, as a lover of books and reading and writing, I'm pessimistic about the future of the whole enterprise. I think making a living as a writer, outside the usual handful of trust fund minor-celebrity lit-fic authors, is going to involve a lot of machine assistance, to the point that "writing" will mostly be massaging and curating the output of machines. Ghostwriters beware—and/or get ready to quintuple your output, using new tools, just to keep your head above water. In the meantime, a little help from tools like this might get the last generation of small-time authors, with actual ideas of their own but without an eye for editing, to print, before that becomes all but impossible even for the very-talented.

It's a good thing there's already enough excellent fully-human-produced writing to last even fairly-avid readers several lifetimes. At least until and unless life extension really gets going.

[EDIT] I'm aware, incidentally, that some of these paragraphs disagree with one another. I stand by my contradictions. :-)

Re:Writing like a pro with Vale and Neovim by BeFlatXIII on Saturday June 18, 2022 @11:01AM (#31790394)
Ok, rich uncle penny bags. [Or you're and have found a community that edits each other's posts for social bonding]
Re:Writing like a pro with Vale and Neovim by hsbauauvhabzb on Friday June 17, 2022 @07:25PM (#31785777)
Should I use an editor for all emails I send, or just the important ones?
Re:Writing like a pro with Vale and Neovim by cratermoon on Saturday June 18, 2022 @01:43AM (#31787505)
As both a writer and an editor, tools like this are essential. Most writing is done in the context of an organization, like a publication or company. Those organizations have style rules. Rules for things like US or UK spelling, for usage questions where there is no single correct answer. Maybe they start with the Chicago Manual of Style, but add custom rules. Maybe it's the New York Times Manual of Style and Usage. It's just like a style checker for code. It frees writers and editors from having to worry about details to focus on the important and difficult aspects of writing.

What details? Things like "do you use 's for possessives even for a word/name ending in s, or is it s'?" or "oxford comma or no?". Writers argue over these just like programmers argue over tabs v spaces or the place of braces. Sure, if you're just blogging for personal use, go crazy, don't worry about a consistent style, do what you want. When writing for publication, instead of arguing over whether or not it's ok to use certain slang or contractions, the editors just chose a preferred way.

Tools like Vale streamline the process of aligning to a style, just like coding style checkers and autoformatters relieve programmers of the tedium fixing up all the indentation manually.

Re:Writing like a pro with Vale and Neovim by stingraycharles on Friday June 17, 2022 @02:14PM (#31782135)
This seems to be an overly negative take on the article. There are many different qualities of good writing, and this happens to automate one of them.
Re:Writing like a pro with Vale and Neovim by augusto-moura on Friday June 17, 2022 @10:24PM (#31786795)
I just consider it on the same category as proofreading. Even if you are an super-author you still need someone to pond on it. There's nothing wrong on getting input on your texts by humans why would it be different by machines?
Re:Writing like a pro with Vale and Neovim by capableweb on Friday June 17, 2022 @01:55PM (#31781861)
I don't think Vale aims to bring someone that already knows English into mainstream-author territory of writing, but rather help with basic/medium errors that everyday writers do. Or even help people who maybe don't write that often.
Re:Writing like a pro with Vale and Neovim by alehlopeh on Friday June 17, 2022 @03:48PM (#31783350)
I don’t think “writing better” is even a question, so what are you expecting out of an answer? Whatever it is, this article doesn’t claim to have it.

TFA is explicitly targeting technical writing.

Re:Writing like a pro with Vale and Neovim by Semiapies on Friday June 17, 2022 @04:44PM (#31784102)
And specifically certain prose issues in technical writing.

It's like writing is a complex activity, and just one of its sub-tasks is editing prose.