News for hackers. Stuff that matters.
Re:Using a Framework will harm the maintenance of your software by dagw on Thursday October 13, 2022 @03:25AM (#33188218)
Of which you are the creator and expert

No, I'm not. The guy who quit 2 years ago was. I've worked with custom frameworks, and while they where both clever and powerful with some quite cool features which would have been tricky to do in a more generic framework, they where also virtually undocumented, fragile, difficult to extend and slow to get people up to speed on.

Re:Using a Framework will harm the maintenance of your software by spion on Thursday October 13, 2022 @04:52AM (#33188736)
Building a library or a framework comes with implied obligation to write extensive documentation. I wish more software engineers understood this.
Re:Using a Framework will harm the maintenance of your software by dandellion on Thursday October 13, 2022 @05:35AM (#33189000)
I'm confident most software engineers I've worked with understood this. Usually the problem wasn't understanding that but rather meeting the deadlines and finding the resources to write that documentation. The only time I've seen documentation done really well, the company had a dedicated technical writer whose main job was making sure they had good documentation. Engineers would write the first draft and hand it off to the tech writer. My impression is that many companies don't want to spend resources on that level of documentation, which is the level you'd probably want to roll your own framework.
Re:Using a Framework will harm the maintenance of your software by spion on Thursday October 13, 2022 @10:28AM (#33191454)
I meant it "part of the job" the same way unit tests are.

I see this more often when the project is open source. For some reason we feel like when its not, we don't need to pay attention to the documentation. Nothing could be further from the truth.