|
Sometimes management forces you to write documentation - documentation that nobody ever will read - so you use a tool to pump out a steaming mound of pulp, show it to management, and move on.
The point is: Know your audience.
|
|
|
|
|
Doxygen was documentation in the 1990s, before your IDE could show you all the classes in your project, and you had to have paper documentation. Not so much today.
Doxygen is not documentation if you don't use Doxygen comments to at least say what function args mean, but rely exclusively upon what Doxygen finds by itself, again because your IDE already does that.
|
|
|
|
|
The problem isn't doxygen, the problem is people thinking that using such a tool creates useful documentation all by itself.
If you can't come up with sensible comments at the right places, sensible function and variable names, and clean code, then no tool in the world will magically turn that code into well documented code!
GOTOs are a bit like wire coat hangers: they tend to breed in the darkness, such that where there once were few, eventually there are many, and the program's architecture collapses beneath them. (Fran Poretto)
|
|
|
|
|
Stefan_Lang wrote: The problem isn't doxygen, the problem is people
I never blame the tool, only the people using it (except if the tool doesn't work properly, but Doxygen does).
GCS d--(d-) s-/++ a C++++ U+++ P- L+@ E-- W++ N+ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t+ 5? X R+++ tv-- b+(+++) DI+++ D++ G e++ h--- r+++ y+++* Weapons extension: ma- k++ F+2 X
|
|
|
|
|
star couple discard constellation (8)
|
|
|
|
|
Is is asterisk ?
"I didn't mention the bats - he'd see them soon enough" - Hunter S Thompson - RIP
|
|
|
|
|
|
Perhaps Obelix? Getafix?
Nah ... it's Dogmatix!
"I have no idea what I did, but I'm taking full credit for it." - ThisOldTony
"Common sense is so rare these days, it should be classified as a super power" - Random T-shirt
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
I think you know the answer is no.
|
|
|
|
|
Time for a Oi Greg Utas
@petepjksolutionscom
"I didn't mention the bats - he'd see them soon enough" - Hunter S Thompson - RIP
|
|
|
|
|
I was busy ... doing exciting things, like slicing ham and washing up.
"I have no idea what I did, but I'm taking full credit for it." - ThisOldTony
"Common sense is so rare these days, it should be classified as a super power" - Random T-shirt
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
First one sounds OK
"I didn't mention the bats - he'd see them soon enough" - Hunter S Thompson - RIP
|
|
|
|
|
The first one causes the second though ...
"I have no idea what I did, but I'm taking full credit for it." - ThisOldTony
"Common sense is so rare these days, it should be classified as a super power" - Random T-shirt
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
I guess you're so remote that you have to butcher your own hogs, eh?
|
|
|
|
|
No, pigs take far too much space - plus they turn it into a quagmire and a very smelly one at that.
I just buy gammon joints and cook them in the slow cooker. Let 'em cook, and slice 'em for sandwiches. That way you have a better idea what's in it, it works out cheaper, and it's kinder to the environment because there is a load less packaging.
Tastes better too!
"I have no idea what I did, but I'm taking full credit for it." - ThisOldTony
"Common sense is so rare these days, it should be classified as a super power" - Random T-shirt
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
And a lot less smell
"I didn't mention the bats - he'd see them soon enough" - Hunter S Thompson - RIP
|
|
|
|
|
What part of the pig is a "gammon joint"?
Sounds like a bar I used to hang out in.
"She's as sweet as Tupelo Honey" - Van Morrison
|
|
|
|
|
Back in the day, I think it is what we left ponders called a fresh ham. (uncooked).
>64
If you can keep your head while those about you are losing theirs, perhaps you don't understand the situation.
|
|
|
|
|
Oooo! Gammon ham [dribbles uncontrollably], yummy! I miss that here in this failed colony!
- I would love to change the world, but they won’t give me the source code.
|
|
|
|
|
I am learning web development and I want to know that I am ready to do freelancing. so I need to find free projects to do. is there any way to find free projects. and how do I know that I am ready to do freelancing?
|
|
|
|
|
Finding ways to contribute to open source on GitHub - GitHub Docs[^]
Not sure how anyone knows they are ready to "freelance". I would suspect that your skill set would need to be strong enough and marketable enough to go it on your own.
I am sure there are a lot of websites that would help you on freelancing and everything that involves, etc.
|
|
|
|
|
|
chamith janaka wrote: how do I know that I am ready to do freelancing You don't, it takes
Resources - you need to eat while you are trying to find clients
Contacts - apart from the various freelancer type web sites you need to build up a network of clients/contacts
Rhino Hide - can you take being rejected for the first hundred or more approaches you make
Admin Skills - after all you will be running a company of some description
And that does not even touch on the analysis, development, deployment, documentation and support skills you will need to bring to the market.
Good luck!
Never underestimate the power of human stupidity -
RAH
I'm old. I know stuff - JSOP
|
|
|
|
|
chamith janaka wrote: I am learning web development and I want to know that I am ready to do freelancing If you are learning, you are not ready to freelance. Freelancers are brought in with the expectation that they have high levels of skill, knowledge and experience - and will hit the ground running. Which justifies their remuneration being much higher than permies.
Any company that is prepared to to take on junior freelancers is, almost certainly, expecting to pay peanuts; provide zero training and offload you at the drop of a hat.
My advice would be to get a 'real' job, with a company that is prepared to commit to your development over the next 2-3 years.
|
|
|
|
|
Aren't free projects and freelancing antithetical? How does one expect to get paid working on something that is given away at no cost?
I’ve given up trying to be calm. However, I am open to feeling slightly less agitated.
|
|
|
|