So it states that “the recommended way of using it is through Docker” which is immediately a red flag. Why would I want something complicated like this if I can just run
rdoc lib (shipped with Ruby’s standard library) and have proper documentation?
There would need to be substantial benefits if we need to jump through hoops like this.
That’s a great point! As our intention was to output an static website, Next.js just made sense, since we could use new technologies and still be able to generate HTML and JS allow it to be hosted without worrying too much about static assets.
Personally, I’d rather just run a container instead of installing Node on my machines, therefore the recommendation. But you are able to just clone and use it if you wish to.
By the way, if you have any thoughts on how we could do better on this part, I’d love to know! Specially if we can ditch Node altogether and just use plain Ruby. <3
You might take inspiration from the latest Rails development which tries to avoid external dependencies as much as possible. And the Bridgetown guys/gals are also in the process of removing (or have already removed) the dependency on Node.js.
What I would like from a new documentation generator like docrb is integration into static website generator tools so that the API documentation can be an integrated part of the website, not just an add-on to it. I have done something like this with webgen and RDoc, see https://hexapdf.gettalong.org/documentation/reference/api/HexaPDF/Content/Canvas.html#method-i-translate as example where the API documentation is built when the website is built. And the API documentation is also enhanced with automatically generated images.
Sure! Just updated README to include a screenshot and a link to a demo ✨
Hi Paul! Thank you for the feedback! It is indeed absurd it is not responsive, but we’re working on it. <3
I’ve always assumed Stripe’s docs, like most other API references, are generated by using Swagger/OpenAPI or similar. Docuowl looks nice but maintaining docs separately is often problematic. Using Swagger or ReDoc to generate docs from a spec is much more effective than manually maintaining them.
That said, this looks nicely styled and I can see it being useful for smaller projects.
Hi there! Thank you for the feedback! Using Swagger/OpenAPI is indeed better for bigger projects, and I completely agree with you that it may become problematic. In our case, we will for sure have extra work to maintain everything updated, but I think it is worth it, since using Docuowl over Swagger/OpenAPI can lead to a better (visual) result. Maybe in the future we can try to find a way to transform ReDoc into a Docuowl site! :D
Docuowl definitely looks nicer than the default Swagger UI :-) I chose ReDoc for my last project because it had a nicer UI, although customising it was a bit tricky.
I’ll definitely consider this for some personal projects where Swagger is too much :-)
Been using GK64 for a while now. Can’t see myself using any other keyboard. I just love every aspect of it.
My vote goes to 1Password, for ease of use, built in security model (client side encryption), versatility in handling all kinds of data (notes, credit cards, etc) and reliability of the plugins to work with all websites and apps. Other password management apps that I’ve tried have frequently had problems with some websites. Sometimes 1Password still has edge cases where e.g. 2FA is not automatically filled in and you have to copy paste it manually. But I haven’t seen a better app yet.
My work used LastPass and I couldn’t have created a worst UI if I’d tried. There was no easy way to generate a new password. It took three clicks in non-obvious places to get to it.
I used LastPass for several years before switching to 1Password a year ago. Wish I had switched earlier. LastPass’s UI design needs a lot of work and over time actually got worse with various annoying small bugs.
Hard no to LastPass. I used it years ago, audited it one evening on a lark, found a few vulns, reported them, a couple got fixed, a couple got me told to fuck off.
And also, LastPass: Security Issues
When I previously used LastPass, there were some weird differences between the browser version and the desktop version - there were some things that each of them couldn’t do.
One oddity worth noting - I don’t use the desktop app with 1Password. I’ve found their browser extension, 1PasswordX, to be more stable (it also has the benefit of working on Linux).
I believe with the addition of HaveIBeenPwned integration on the LastPass security dashboard, they’re pretty much similar feature wise (though maybe 1Password can store 2FA tokens). I’ve used 1Password because it felt way less clunky than LastPass and it doesn’t require me to install a random binary on my Linux machines in order to access my passwords.
I switched to 1Password from LastPass a couple years ago and haven’t looked back.
LastPass got unusably slow for me after I had more than a few hundred entries in it. I don’t know if they’ve fixed their performance problems by now, but I can’t think of anything I miss.
Long time 1Password user here. It’s by far the best tool I’ve ever used. And I believe it goes beyond the application itself, as the support team is also great. Given a matter as sensible as all my credentials to login into several different services, having good support is mandatory IMO.
1Password here too. Excuse the cliché, but it just works. The cost is minimal for me — $4/mo, I think.
I’ve been slowly moving some 2FA to it, but it seems dependent on 1Password itself detecting that the site supports it vs. something like Authy where I can add any website or app to it.
I just switched to 1Password after 5-10 years on Lastpass. There’s some quirks, it’s not perfect, I generally prefer it to Lastpass.
The only thing Lastpass truly does better is signup form detection. Specifically I like the model Lastpass uses of detecting the form submission, 1Password wants you to add the password prior to signing up, which gets messy if you fail signing up for some reason.
1Password wants you to add the password prior to signing up, which gets messy if you fail signing up for some reason.
Oh yeah, this is a constant frustration of mine. ALso, whenever I opt to save thep assword, I seem to have a solid 4-5 seconds of waiting before I can do this. This seems to be 1Password X, FWIW. Back in the good old days of 1Password 6 or so when vaults were just local files, the 1P browser extension seemed to save forms after submission.
I’ve been able to get my whole family onto a secure password manager by consolidating on 1Password. I don’t think I would have been successful with any of the other options I’ve found.
It’ll be curious to see how many companies uses Sponsors to support some of the open source projects that they rely on. I suspect that the average OSS developer will get more financial support from his or her fellow developer than any one company unless it’s a major OSS project. I more see a future where Big Tech spins out their OSS work into a not-for-profit reliant on things like Sponsors in order to reduce corporate overhead.
I’m pessimistic… I know…
I feel the very same way, szul. Either GitHub does not provide visibility of companies sponsoring individuals (is that even possible through their platform?), or no company does that at all. On the other hand, I see several individuals supporting the work of OSS contributors, which is awesome, but I think companies that hired those individuals should provide a way to compensate them, effectively giving back by using their contributions.
Maybe I’m too optimistic. I don’t know.
Been using GK64 for a while now. Love it.
For special projects, I use a Fabriano notebook.
However, I have recently (re-)discovered that having a super cheap spiral notebook increases my note-taking by a factor of 100x and that note-taking is a fantastic way to organize thoughts. I have since filled many of those. Something like 140-page Hilroy 1-subject notebooks.
I’ve been using the Pilot G2 exclusively for over 10 years now. I buy them in bulk and always have 3 to 5 of them on me. I enjoy seeing them spread in other peoples hands wherever I go, so when someone asks for a pen I’m always the first to offer them one of mine and never ask for it back.
The G2 is a fantastic pen. I prefer the 0.38 tip size becethe flows so well and takes just a moment to dry.
Not an artist nor anything alike, but I simply love products by Fabriano. I always carry with me an A4 Notebook (Glued Long Side) with dots instead of lines. The 85g/m2 paper is perfect for the 0.1mm Uniball Pin. I’ve been using those for a long time now.
Feel like everything looks better with this combination, specially mathematical stuff.
So you may like this post
Thanks for the tip! Pilot also makes a G2 Limited which is a fancier exterior but takes the same fills which should also work.
The core problem is the only entities currently paying for web browser development have mixed motives. The EU should just buy out Mozilla and make Firefox into the browser for the people instead of waiting around for Google to stop breaking their laws.
No thanks, I’ve had enough cookie popups for one day.
The GDPR is specific about cookie banners not being obtrusive, and that rejecting tracking is as easy as accepting.
The only compliant banner I regularly see is from gov.uk, and I find it doesn’t annoy me at all.
The popups are as obnoxious as possible to make us hate the GDPR. Can’t we oppose the tracking instead of the law telling us when it’s happening?
And of course the core thing is you don’t need the cookie popups if you’re not doing random tracking of people!
Every cookie popup is an announcement that the site has some automated trackers set up. If you are just using cookies for things like handling sessions you do not need the cookies.
Absolutely. The options are either make your tracking opt-in through genuinely informed consent, or don’t track at all.
Companies found the secret third option, which is just ignore the law and dark pattern your users into agreeing to anything.
Banners say things like “we need cookies for this site to work” and pretend they need your permission to use them. Ironically they only need permission for the cookies that aren’t essential to make the site work.
Hiding things away under “legitimate interest” makes things even more confusing. Are the other things illegitimate interests?
Can someone explain to me what “legitimate interest” actually means?
Do you mean the cookies or the popups? I’m not familiar with how the GDPR treats non-cookie based things like JWT in local storage and sent with every request.
The same. You require consent to store any data on user computer. However it do not require some “essential” cookies - for example cookie with preferences for dark/light theme do not require consent if it is direct action on website, cookie containing session ID do not require consent, etc. That applies for local cookies only though.
Same. I really wish companies would stop choosing to add them to their websites.
If you already block tracking by any mean, you can get rid of those banners using something like https://addons.mozilla.org/en-GB/firefox/addon/i-dont-care-about-cookies/.
Yeah, the EU’s heart was in the right place, but implementation has been a disaster. It’s like passing a law that murder is okay as long you say “I am going to murder you” as you take out the knife.
What the EU did was basically passing a law that makes murder illegal. Companies/Murderers just ignore it and go around saying “anyone that doesn’t want to be murdered please answer by saying your name within of the next millisecond. Guess no one answered, so you’ve just consented to murder!”
GDPR explicitly bans all the annoying dark patterns of cookie banners. A GDPR-compliant cookie banner would ask you once whether you consent to tracking. It’d have one huge no button (but no easily accessible yes button). If you ever click no, it’d have to remember as long as possible and close itself immediately. If you click yes, you’d have to go through a handful of options to specifically choose which tracking methods to allow.
So, basically the polar opposite of many cookie popups today, which have a big “I ACCEPT” button and a “More options” button that you have to click to manually turn off all tracking…
Indeed. Which is now finally happening: https://www.theverge.com/2022/4/21/23035289/google-reject-all-cookie-button-eu-privacy-data-laws
Except large Internet companies are much more powerful and accountable to public pressure than murderers, so they should face at least as much public scorn as the lawmakers.
There’s a saying, that road to hell is paved with good intentions.
That often means that if someone’s is not sure how to help, then proceeding with helping can create more problems than resolve anything.
That’s better than having no law against murder. Then we can move away from all the people saying “I am going to murder you.”
Cookie popups on websites linked to by Google?
What’s to buy? It’s open source. They can contribute to it or fork it if Mozilla Corp doesn’t like their changes.
The Mozilla organization, including the expertise necessary to develop and maintain Firefox. It would probably cost more to build an independent organization capable of doing the same thing.
Which Mozilla organization? The non-profit Mozilla Foundation or the for-profit Mozilla Corporation?
I’m not sure, what do you think?
The Mozilla Corporation is owned in its entirety by the Mozilla Foundation. Even if somehow the Foundation were convinced to sell the Corporation, the Foundation is the one that owns the key intellectual property and is the actual steward of the things people think of as “Mozilla”. The Corporation’s purpose is to be an entity that pays taxes and thus can have types of revenue and business deals that are forbidden to a non-profit.
The employees who work on Firefox and everything that encompasses work for the Corporation. It has more of a purpose than “taxes”.
I am a former employee of the Mozilla Corporation, so I am aware of what the MoCo employees do.
MoCo gets all of the revenue that’s generated by Firefox and employs most of the developers. All but one of the members of the Firefox Technical Leadership team work for Mozilla Corp - the one that doesn’t did until relatively recently: https://wiki.mozilla.org/Modules/Firefox_Technical_Leadership
While the Foundation technically owns the IP the Corporation controls the direction of the product and collects all of the revenue generated by the work of both their employees and contributions from the community.
Declare Firefox a public infrastructure and fund Mozilla or another entity to upkeep and enhance that infrastructure.