HNHacker News
TopNewBestAskShowJobs

samayylmao

136 karma · joined August 22, 2017

submissionscomments
samayylmao··on Ask HN: How To: Internal Documentation?
+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.

samayylmao··on Ask HN: How To: Internal Documentation?
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.

samayylmao··on ASP.NET Core Blazor
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.

samayylmao··on ASP.NET Core Blazor
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.

samayylmao··on ASP.NET Core Blazor
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.

samayylmao··on ASP.NET Core Blazor
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.

samayylmao··on Netflix Removes “Basic” Ad-Free Plan in U.S. and U.K
Is Netflix using Canada as a test case for how larger markets will react to that change?
samayylmao··on Chiptune.app
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.
samayylmao··on I regret using Ionic for app development
I'm not sure Maui has been production ready long enough. It has not even been GA for a year yet.
samayylmao··on A short history of the VW Mark 1 Rabbit/Golf (2021)
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.

samayylmao··on FCC Considering Banning Transfer of Online Consent Forms
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.

samayylmao··on Teddit: a free and open-source Reddit front end focused on privacy
And accessibility trolls are hot right now.
samayylmao··on Cobaul: A COBOL to WebAssembly Compiler
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.

samayylmao··on Security by obscurity is underrated
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.

samayylmao··on Chef to be acquired by Progress
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?

samayylmao··on Show HN: Income/savings calculator for moving to Canada
would you be able to retire on RRSP alone?
samayylmao··on Don't Talk to the Police
His speaking style is very engaging.
samayylmao··on One way to fight a coronavirus recession: $1k for every American
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.

samayylmao··on Why Enterprise Software Sucks
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.
samayylmao··on Fears grow over 'food swamps' as drugstores outsell major grocers
> 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.

samayylmao··on Fears grow over 'food swamps' as drugstores outsell major grocers
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.

samayylmao··on The Dark Side of Dark Mode
are the claims that dark mode makes you "slower" and "stupider" founded?
samayylmao··on Maine passes bill to prevent ISPs from selling browsing data without consent
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.
samayylmao··on Chrome extension manifest v3 proposal: comment from uBlock Origin author
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?

samayylmao··on New Game: Minecraft Earth
My sleep code always compiles and always works as intended.
samayylmao··on Microsoft turned down facial-recognition sales on human rights concerns
Seems like a situation where doing the right thing is luckily in the best interest of Microsoft.
samayylmao··on Students Support Socialism, but not when it comes to their GPA
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)

samayylmao··on I’m 14, and I quit social media after discovering what was posted about me
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.
samayylmao··on I’m 14, and I quit social media after discovering what was posted about me
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.
samayylmao··on I’m 14, and I quit social media after discovering what was posted about me
I respectfully disagree. Children have a right to their own privacy from the rest of the world and it is a parents' responsibility to respect that. My son is only 11 months old but neither my wife, our family/friends, or myself post pictures of him or any intimate details on social media. They can be shared privately but not on social media.
Page 1 of 2Next →