• 1 Post
  • 12 Comments
Joined 1 year ago
cake
Cake day: June 5th, 2023

help-circle






  • The issue I see a lot in the JS ecosystem is laying out documentation like a reference guide, but then not including all parameters or functions. These types of documentation are very helpful if what you need to know is included, because they have nice friendly explanations and examples. But eventually you will run into a parameter that is mentioned on Stack Overflow, or is in a code snippet in the documentation, but then has no further explanation in the documentation, as if it doesn’t exist.

    Projects where the README is the only documentation seem to suffer from this problem the most. They give examples of the most common parameters and functions, and then that’s it.

    In JS this is a big issue because there may be no way to know a parameter even exists, or what values it accepts, unless it is documented.

    A lot of documentation in the Java ecosystem has huge auto-generated monstrosities with absolutely no explanations. In Java this is usually not useful because that information can be found in the types. But in JS it would be incredibly useful. Unfortunately it isn’t as easy to automatically generate that type of documentation for JS.

    Python in my experience has the best of both worlds. It has the friendly explanations and examples. But also has all of the parameters, even if explanations for some are a bit less detailed. And all of that is combined into a single place.





  • For a Reddit/Lemmy app though I would still prefer images to load in the app itself, because it’s more seamless. For now Jerboa handles images and GIFV just like any other link.

    RIF let’s you configure this, which is nice. For Jerboa I think the default should eventually be to load them in the app itself (RIF calls this “Native”).

    Edit: Jerboa does already load the OP image in-app when you open the comments. I think that behavior shouldn’t change. It’s just when you open the image from the news feed that it opens it like a link currently.


  • When you open a link from Jerboa it should open a mini in-app version of your main browser. If your default browser app is set to Firefox it will say “Powered by Firefox” and if it is Chrome it will say “Running in Chrome”. UX wise it is very similar to having a bundled in-app browser. But the rendering is handled by your main browser.

    I’m not up-to date with the story behind this, but my understanding is that new apps that want in-app browers should be implemented in this way. This seems to be the modern way of doing it. The reason for it I believe is mostly security. Your main browser app should be up-to-date on security patches and features, and if apps can just piggie back off that then they don’t need to worry about shipping and patching their own in-app copy of the browser. Also it respects the user’s choice of default browser. So if your default browser is Chrome it will use that for the in-app browser for all apps that work this way (which is quickly becoming most apps).

    Another advantage of doing it this way is that when you use the “Open in Firefox” button it seems to just move the tab from one app to the other rather than reloading it, so it happens almost instantly.


  • torturedllama@lemmy.nztoSelfhosted@lemmy.worldWhich Lemmy app do you use?
    link
    fedilink
    English
    arrow-up
    43
    arrow-down
    1
    ·
    1 year ago

    I’ve been using Jerboa so far. It’s pretty nice. At first I was a bit sceptical because it seemed a little half baked. But it’s growing on me. Also now that I’ve used it for a while I think it’s relatively well rounded feature wise. It is quite minimal, but I think a lot of people probably like that. I think long term if other apps come up that are more similar to the existing 3rd party Reddit apps I will probably switch though.

    My main issue so far is not being able to follow links to communities inside the app. I imagine this will probably be more difficult to implement than on Reddit because of federation, but hopefully apps can get that working eventually.

    Also it can be difficult to add new communities from other servers even via search. Which is also a federation issue.

    I also miss the features from Reddit Is Fun which let you choose which content is displayed in-app vs in a web browser. But that’s only a minor annoyance so far.

    I find I am getting used to the visual style of comments. I initially didn’t like it, but it’s growing on me.