Mark Erikson comments

Results 1264 comments of


                                            Mark Erikson

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

One thing I'd like us to do as part of the docs rewrite is to drop terms like "simple", "easy", and "just" from our docs entirely. Here's an article with...

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

I like how the Cypress docs prefix each page with a "What You'll Learn" callout: https://docs.cypress.io/guides/getting-started/installing-cypress.html Example: > ### What you'll learn > > - How to install Cypress via...

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

Some good suggestions for creating short readable code samples in docs: https://ts.chibicode.com/refactor - Make code samples mobile-ready - Prefer minimal code samples - Prefer practical code examples - Fail fast...

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

Google just posted a set of "Technical Writing" mini-courses: https://developers.google.com/tech-writing

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

The Vue docs have a great set of writing guidelines here: https://v3.vuejs.org/guide/writing-guide.html

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

And Digital Ocean has some excellent guidelines as well: https://www.digitalocean.com/community/tutorials/digitalocean-s-technical-writing-guidelines

[Docs Rewrite] Discussion: Docs writing guidelines and issue templates

The Solid folks just put up a docs writing guide that looks pretty good: https://github.com/solidjs/solid-docs-next/blob/main/WRITING.md

Inlining wrappers over `createSelector` causes selector args to be of any type

Huh. I'll be honest, I have _no_ idea what's going on here and am not really even sure how to start debugging this one :) (This goes along with my...

Inlining wrappers over `createSelector` causes selector args to be of any type

Yeah. If you look at the commit/issue history of this repo over the last few weeks, you can see that I (and a few others I've dragged in) have been...

Inlining wrappers over `createSelector` causes selector args to be of any type

@garrettm what is the inferred type of `foosDerived` when you mouse over it, on both of the lines that it's used? Also, what happens if you call `foosDerived()` with a...