HN user

verletx64

175 karma
Posts13
Comments73
View on HN

Technical writing is a difficult skill to be proficient at, so I think dedicated technical writers are needed in many companies. I’ve also not really seen writers be “blown off”. More often I see an absence entirely of writers, but that’s usually more to do with budgeting more than anything else. Where I’ve had writers working with me, we’re generally thankful to have someone proficient at it handling things.

With that said, I don’t really see the English major idea panning out well, just as bootstrapping a project with a bunch of CS grads probably wouldn’t. The study and analysis of literature is tangentially connected with technical writing for commercial purposes.

They can, of course, become good technical writers over time, but a huge component of what writers bring is an understanding of the audience. It goes beyond being able to write well, and academic writing is different from commercial writing.

But then does the developer now need to track this list of production test cards and make sure the application doesn’t enact some other logic based on the test purchase?

I mean really, you can get 99.9% of the way there with the test cards in the sandbox, and then give the thing a smoke test in production when you’re ready.

I would say it's primarily a web application for note taking (there's some auxiliary capabilities around kanban boards, etc, but most people I know who use it, use it as a rich text editor).

I think where Notion differs from others, and where it has similarity to Org-Mode is it's ability to create 'blocks' with more dynamic behaviours (calendars, kanban blocks, tables) as well as how easy it is to create linkages between pages.

I'd imagine it's probably people with less than a few weeks of coding experience

In the end everybody eventually needs to learn from written content; not only for the viewers efficiency, but also because it's more efficient for content creators to produce written content over video content.

You can even guess your 'reckon' from looking at the kind of video content that is out there - again, this seems mostly to be a consequence of creator efficiency.

With that said, who cares?

Hell, I sometimes hit up streams - for instance, Antirez has been streaming himself building out parts of Redis 6, because it may introduce me to new techniques or minutae I didn't know. It's way, way, way more chill than reading source code, and it's a lot better than the blog post on it he probably won't write.

I care about touch typing using the keys I frequently interact with in the editing experience. F-keys, as you say, may be used for adjusting brightness, or sound, but this is not in my editing experience. I’m not repeatedly adjusting sound or brightness unlike for instance the esc key in vim.

I would also say it’s worth saying a lot of developers don’t actually touch type, or have grown more used to GUI workflows. The idea of a hardcore developer building software with their mouse turned upside down is one that I find outdated.

I agree that damage is going overboard language wise, however, that’s what happens when the card itself is supposed to be designed to be distinctive. Anecdotally I’ve had people express interest in it because it looks nice.

Would be true if Typescript significantly differed, but as it is, it’s basically JS with a few type annotations. The only learning curve is typing these dynamic constructs properly, rather than wrapping your teams head around other concepts, constructs and patterns.

I’d recommend using ‘unknown’ over ‘any’, it’s truer to the code you’d probably end up writing if it was vanilla JS; fairly defensive stuff.

On top of that don’t be hesitant to define ad hoc interfaces on your side of things; ultimately ‘any’ communicates zero information and provides zero defence.

The more I start to use other techniques the more I feel that ‘any’ really should be the last escape hatch deployed.

Worth saying, sometimes there’s nothing to google, or googling wouldn’t yield a significant answer - perhaps the issue lies in some module of fairly home grown code.

I understand that you feel that Electron isn’t worth optimising, and your answer offers up a good alternative to Electron.

However, this is an interesting question in and of itself, and I think it’s worth hearing out the answers. Could be some interesting techniques to pick up and reapply elsewhere.