News for hackers. Stuff that matters.

samayylmao

Re:Ask HN: How To: Internal Documentation? on Sunday September 01, 2024 @08:34AM (#41416488)
+1 for protobuf/open-api.

My team has been using swashbuckle in the dotnet API ecosystem which generates an open-api document based on your code, commemts and c# attributes (for the things it can't infer from the former). The documentation and code have a symbiotic relationship.

Re:Ask HN: How To: Internal Documentation? on Sunday September 01, 2024 @08:26AM (#41416418)
I work at an organization where we build mostly internally used tools to support different products/service lines. Here's what I've been advocating for and it works fairly well without requiring a lot of time to write documentation that is, often out of date. I find mileage varies as some people always just ask a senior engineer and never look at the documentation.

We have a high level wiki page about each application/micro service we support. Things like - resource locations - job schedules, purposes, inputs/outputs -FAQ's - known dependencies on other micro services, etc

We also have wiki pages for - onboarding - team norms and expectations (pr process, on-call duties, coding conventions, etc)

Inside each application's or micro service's repo the readme should have steps to - get the project running locally. - document feature flags - document conventions unique to that project - document how to trigger a release

Someone here said the code should be the source of truth and other documentation isn't needed. To me it's unclear what they mean by that exactly; I could get behind that if they are documenting via comments on functions/classes/etc. my org tends to not write much comments in the code so it's really hard to tell if the code does what it was intended to do or if there is a bug. What I love to see for "self documenting" code is tests. You write tests to either test for outcomes you expect or test outcomes that you don't expect, don't happen.

Re:ASP.NET Core Blazor on Saturday October 07, 2023 @07:09PM (#37806277)
I've been using blazor since release in 2019 and can count on one hand the amount of times a call to StateHasChanged() was used and actually needed when doing a peer review

Most of the time I've seen that function used it was due to improperly written asynchronous code.

Re:ASP.NET Core Blazor on Friday October 06, 2023 @10:34PM (#37798541)
My specific critiques revolve around the state of tooling and the developer experience.

I went into [some detail](https://news.ycombinator.com/item?id=37798121) on another comment on this thread.

Re:ASP.NET Core Blazor on Friday October 06, 2023 @09:03PM (#37798135)
I think it's bad advice because the fundamentals of web development and core programming concepts are mostly transitive between frameworks.

You can learn that on blazor and apply it elsewhere.

That being said I have worked with blazor since launch in 2019 and it's one of my least favorite SPA frameworks.

Re:ASP.NET Core Blazor on Friday October 06, 2023 @09:00PM (#37798121)
if you havent used blazor before there are some downsides.

The developer experience with blazor is lacking. Debugging tools aren't up to par with other dotnet SDKs. Hot reload only works when not debugging and only if you don't modify member signatures and a plethora of other conditions. Because of the afore mentioned the feedback loop during development can be slow. The razor editor doesn't support all the helpful actions you're used to with dotnet (e.g. cleaning up unused imports). Sometimes the razor editor gives really bizarre errors and you simply need to close Visual Studio and reopen for the. tk disappear

I dont mind the framework itself but there's a few design decisions that could have been better.

I think there are some good use cases for it though. AOT compilation to wasm is kinda neat for workloads that may benefit from that.

I also think that blazor server might just be the most novice friendly way to get I to web development because it abstracts away much of the web. that being said, the blazor server architecture has a plethora of drawbacks.

Re:Netflix Removes “Basic” Ad-Free Plan in U.S. and U.K on Wednesday July 19, 2023 @11:46AM (#36788301)
Is Netflix using Canada as a test case for how larger markets will react to that change?
Re:Chiptune.app on Saturday July 15, 2023 @08:29AM (#36735987)
For me switching playback device is quick and reliable if the device is a PC or phone. Whenever I try to select a connected Google speaker... it takes like 3-5 tries. I've found it is more reliable to use voice commands to get the speaker to play Spotify then I can use a phone/PC to select the song/playlist/podcast/etc. but it's kind of frustrating it just doesn't work well to begin with.
Re:I regret using Ionic for app development on Saturday April 08, 2023 @08:46PM (#35499097)
I'm not sure Maui has been production ready long enough. It has not even been GA for a year yet.
Re:A Short History of the VW Mark 1 Rabbit/Golf on Saturday March 18, 2023 @04:03PM (#35212581)
My neighbor happens to have the rabbit convertible from the first production year (1980).

it only has something like 30,000 miles on it and is still all original on both the Interior and exterior.

So cool to see as a GTI owner.

Re:FCC Considering Banning Transfer of Online Consent Forms on Friday February 24, 2023 @06:31AM (#34923449)
I went to a Gartner conference one year because my work paid for it. RIP my work inbox ever since. my email has been sold and sold over and over again.

Gartner tells you what you probably already knew them sells your information.

And accessibility trolls are hot right now.
Re:Cobaul: A COBOL to WebAssembly Compiler on Monday September 21, 2020 @01:08PM (#24545846)
First day of intro to programming at my university and the professor was introducing himself and his background and how his first job was writing cobol at a Paper Mill. He said COBOL was a revelation at the time and that we would never need to learn or use it.

Enter stage left my first job as a developer in 2016 and I'm tasked with learning cobol to support customizations to their 25 year old Lawson Implementation.

I'll probably never use it again but reading and writing cobol code opened my eyes to different design patterns not often seen in more modern languages. Seeing clever implementations of features that come out of the box in modern languages was really neat.

Re:Security by obscurity is underrated on Friday September 11, 2020 @04:40PM (#24447115)
I know someone who would rather store passwords/api keys in the database encoded in a way that is not clear text but is not encrypted or hashed arguing that its overkill to encrypt.

Obscurity instead of Security is bad too.

Re:Chef to be acquired by Progress on Tuesday September 08, 2020 @09:00AM (#24407936)
My organization is actually moving away from Telerik after ten years of use.

My biggest complaint is how unresponsive they are to fixing bugs. After reported it may be months or a year before you see it fixed.

What I dont know is if that is common in that "ui component" sector?

would you be able to retire on RRSP alone?
Re:Don't Talk to the Police on Tuesday June 02, 2020 @09:18AM (#23390660)
His speaking style is very engaging.
Two adults working 40/hours a week for minimum wage would bring in 30,160 /year.

If we apply this article's suggestions to your situation: 2,500 (2 adults, 1 child) * 12 months is 30,000 /year.

Like you said, too many people live paycheck to paycheck and our minimum wage keeps it that way. You can barely survive on it.

Re:Why Enterprise Software Sucks on Friday October 11, 2019 @11:05PM (#21230372)
Have you ever used Instructure? My university uses it (I'm a student). It's really great on the student side and from what I've seen really flexible and easy to use from the teacher's perspective too.
> Being poor doesn’t mean you can’t plan and are helpless.

obviously not. But anecdotally what I see where I live is that it is a large enough inconvenience that it makes an impact. If you work 8 hours, then have to spend 2-3 hours getting groceries you already have a 10-11 hour day not counting any other commuting you need to do. What if you have kids you need to get off a bus from school?

trying to blanket say anyone not willing to make that trip just isn't trying isn't fair.

It is well documented that low-income areas have less access to good education, healthcare, and other facilities. blaming the residents doesn't help them improve their quality of life. Not everyone will make it out of that.

If you can't afford transportation you're limited to what you can walk to. In the area I live you cannot bring more than one bag with you on public transportation and it takes almost an hour to get across town on the bus. It would be cheaper to buy marked up food from a gas station or drugstore than pay for a taxi ride or waste half a day riding the bus.

Edit: essentially, a lot of the time it is expensive to be poor.

Re:The Dark Side of Dark Mode on Friday May 31, 2019 @04:24PM (#20064628)
are the claims that dark mode makes you "slower" and "stupider" founded?
I live there and I am proud our lawmakers took this seriously. It seems too common for lawmakers to not understand the ramifications of what was at stake.
If I search for ublock with google I don't get a result pointing to ublock in the google chrome app store.

I do get results for: firefox, opera, microsoft.

coincidence?

Re:New Game: Minecraft Earth on Friday May 17, 2019 @04:14PM (#19943149)
My sleep code always compiles and always works as intended.
Seems like a situation where doing the right thing is luckily in the best interest of Microsoft.
I agree that "wanting free stuff with no cost or contribution" is as you put it "wrong". I would like to see what a government-run single payer healthcare system would look like;also, raise my taxes to cover this. rough math says the government would need to increase my taxes by over 10% for the increase in taxes to equal my current premiums.

Right now we pay more for healthcare than other countries because our system is so flawed. we pay more for both services and the same exact prescriptions that other countries do. I work for a healthcare system and the amount of charity care and unpaid medicare bills are astronomical. If your'e interested I can share a publicly published report that breaks this down. These are also part of the reason that we pay so much more, the people that actually pay need to make up the cost for those that don't.

on top of that, medical claims processing and billing is overly complicated, time consuming, and expensive due to multiple insurers.

My premiums to have my family covered are almost as much as my rent. ( disclaimer: i live in a state with a very affordable housing market)

Good point, I should have said "responsibility to ensure that" instead of "responsibility to respect that". Parents have the responsibility of protecting their child's privacy.
This is one smart kid for that age. The critical thinking and reasoning skills are on point. Its comforting to know that the younger generations are more informed about the consequences of poor use of technology.

Older »