←back to thread

323 points CharlesW | 2 comments | | HN request time: 0.407s | source
Show context
Carrok ◴[] No.42201300[source]
Why do so many projects fail to include any screenshots at all?

Maybe the authors don't think it's necessary, but step 3 under `Getting Started` is called `Creating UI`. Why would they not show what the result of the tutorial looks like?

replies(4): >>42201503 #>>42202073 #>>42205183 #>>42209182 #
Ringz ◴[] No.42201503[source]
Not only are screenshots often missing, but I’m also surprised by how many projects fail to describe the purpose and goals of their project in short, simple sentences. Many mistakenly assume that only users and developers visit the website or repository, not decision-makers. More ELI5 ("Explain Like I'm 5") can never hurt.
replies(1): >>42206461 #
majkinetor ◴[] No.42206461[source]
Writing good documentation is extremely hard. Even 10x engeneers can be basically illiterate.
replies(1): >>42207338 #
1. metalliqaz ◴[] No.42207338[source]
> Even 10x engeneers can be basically illiterate.

I see what you did there

replies(1): >>42208669 #
2. TripleChecker ◴[] No.42208669[source]
There's certainly a persistent issue of typos: (34 here that we found: https://triplechecker.com/s/689196/electrobun.dev).