Most active commenters

    ←back to thread

    Electrobun: Cross-platform desktop applications written in TypeScript

    (electrobun.dev)
    323 points CharlesW | 14 comments | 20 Nov 24 23:58 UTC | HN request time: 2.004s | source | bottom
    1. Carrok ◴[21 Nov 24 05:03 UTC] 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 #
    2. Ringz ◴[21 Nov 24 05:51 UTC] 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 #
    3. xixixao ◴[21 Nov 24 07:53 UTC] No.42202073[source]▶
    Screenshots are harder to produce, maintain and publish.

    I also suspect many technical authors are less “visual” so to speak, putting less emphasis on visual presentation.

    replies(3): >>42202385 #>>42203350 #>>42206078 #
    4. steve1977 ◴[21 Nov 24 08:56 UTC] No.42202385[source]▶
    Not the best thing for a desktop application framework maybe.
    5. jamager ◴[21 Nov 24 11:46 UTC] No.42203350[source]▶
    > Screenshots are harder to produce, maintain and publish

    What, really? What am I missing? If you tell me video, yes, but a screenshot...

    replies(1): >>42203530 #
    6. madeofpalk ◴[21 Nov 24 12:10 UTC] No.42203530{3}[source]▶
    I don't think it's that hard, but it's easier for screenshots to drift and become out of date compared to just written text documentation.
    replies(2): >>42203709 #>>42207731 #
    7. high_na_euv ◴[21 Nov 24 12:35 UTC] No.42203709{4}[source]▶
    It is literally a few minutes of effort

    If you cant do such basic thing, which would significantly improve an ability to understand your product, then wtf

    8. teg4n_ ◴[21 Nov 24 15:24 UTC] No.42205183[source]▶
    i mean in this case it would be a window with any web app in it… not sure that would be particularly helpful.
    replies(1): >>42210063 #
    9. majkinetor ◴[21 Nov 24 17:19 UTC] No.42206461[source]▶
    Writing good documentation is extremely hard. Even 10x engeneers can be basically illiterate.
    replies(1): >>42207338 #
    10. metalliqaz ◴[21 Nov 24 18:48 UTC] No.42207338{3}[source]▶
    > Even 10x engeneers can be basically illiterate.

    I see what you did there

    replies(1): >>42208669 #
    11. conductr ◴[21 Nov 24 19:29 UTC] No.42207731{4}[source]▶
    You’re just trying to give us the gist of things with images. It’s basically selling your thing to me as something I would want to try out. Usually if I connect with something I see in first few moments then my likelihood of trying the thing out is higher.

    We don’t need it to be updated on every commit. Or illustrated docs but some idea of what I’m getting myself into is nice to have.

    12. TripleChecker ◴[21 Nov 24 21:08 UTC] No.42208669{4}[source]▶
    There's certainly a persistent issue of typos: (34 here that we found: https://triplechecker.com/s/689196/electrobun.dev).
    13. ◴[21 Nov 24 22:08 UTC] No.42209182[source]▶
    14. ◴[22 Nov 24 00:19 UTC] No.42210063[source]▶