|
DocFX for documentation, WebSequenceDiagrams for your diagramming needs, bingo bango (which means you're already almost done)!
|
|
|
|
|
You want to leave documentation? Just set the titles, copy-paste man pages for the contents. Nobody ever reads this junk anyway, we all know that the code (if there is a "the" code) is light years away from any existing docs.
No, that's not what I did when I left, but I could have.
|
|
|
|
|
Reading between the lines I guess there was no time allocated for documentation during the dev cycle. You are now expected to rush out a full manual in the limited time you have left.
Bottom line is that documentation takes time to produce, during which no revenue generating activity takes place. Equally, when the guy who wrote the code leaves the building, the business is in jeopardy. Usual reaction to this scenario is PANIC!!!!
We're philosophical about power outages here. A.C. come, A.C. go.
|
|
|
|
|
In addition to the usual architecture diagrams and documentation, I've taken to creating a small Knowledge Base (ours can be partitioned, so I create one for the particular project). Then I walk through and put all the common issues I've come across, or gotchas that I can think of in this Knowledge Base. Typically we start hand over a bit earlier than the cut-over date and any questions that the support team have, I can put these into the KB and then have the support team use that.
Whatever it can't answer, I will and then update the KB for them. It can be time consuming but I think it helps greatly as people can simply 'google' the answer for a particular error or question about the system. It depends how nice you want to be to the people you are handing the project over to I suppose
I also do this when I have been handed a system to support and have no supporting documentation. Creating a KB and putting new articles in any time I encounter a problem helps as I am forced to dive deeper into an issue and fully understand how it works.
|
|
|
|
|
Can an icy cell hold the Pope's letter? (9)
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
Encyclical? but that's 10 letters and needs another 'c' from somewhere.
Otherwise an anagram of an icy cell.
Andy B
|
|
|
|
|
I miscounted - it's supposed to be an anagram of "Can icy cell" with the "an" thrown in to mislead and make a sentence.
But it's the right answer. Do you want it tomorrow, or should I be punished with doing another? Your choice.
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
I'll do it tomorrow
|
|
|
|
|
I hope you can count better than I can ...
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
modified 8-Jun-17 6:36am.
|
|
|
|
|
You of all people - pulling me up on Teresa May
We can’t stop here, this is bat country - Hunter S Thompson RIP
|
|
|
|
|
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
More like Dianne Abbott
modified 8-Jun-17 9:31am.
|
|
|
|
|
Sounds naughty, doesn't it?
Anyway, does anyone use Amazon to sell their stuff? Pros/cons?
I used to use Digital River a long time ago, and now forget why I stopped.
I'm currently doing the whole PayPal IPN thing set up with MojoPortal, and it works...but...PayPal.
Any other services out there that are worth looking at? I just need a click-the-link-on-my-site-to-pay, the buyer goes and pays someone else, then either returns to me for the download (like the IPN thing), or downloads from the same place they paid (like Digital River).
|
|
|
|
|
I am currently searching the internet for info on Face Recognition Software.
Unsurprisingly, the SEO jungle makes this about as efficient as doing college research papers back before the internet ever existed.
If you know what you're talking about with Face Recognition Software, please contribute to this thread (or send me a private message).
As for this immediate moment, my goals, agenda, and requirements are (purposely) not sharply defined. I just want to get a sense of what's out there, and how the various segments of the software work; particularly how they interface with other parts of a given system (e.g., a database, or whatever)
The jargon, vocabulary, nomenclature, and general lingo used in the trade are on my list of things to learn.
If there's a better place here on CodeProject to ask this question, point me.
|
|
|
|
|
I recall Pete O'Hanlon was doing face recognition work for a local museum if I am not wrong. He might be able to help.
"It is easy to decipher extraterrestrial signals after deciphering Javascript and VB6 themselves.", ISanti[ ^]
|
|
|
|
|
That's correct. I have done a fair bit around this already.
This space for rent
|
|
|
|
|
C-P-User-3 wrote: If there's a better place here on CodeProject to ask this question, point me. The Quick Answers[^]?
I'll go get my coat
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
There are plenty of articles here on CP on that subject, two of the most eminent ones are to be seen here[^] and here[^].
The first one is a bit old, but explains the principle quite well, the second one uses what seems to be the most common library at the moment.
|
|
|
|
|
|
|
A colleague has just attended a conference for open source .net and was speaking to some people who have gone beyond pair-programming to mob-programming. They have 2 60" screens, 2 devs, the project owner and a designer all working as a team with one person driving the keyboard.
The company seems to feel that the ROI makes the process worthwhile.
Not sure this would be for me; I don't like rigid pair-programming but am OK with opportunistic-pairing where it makes sense to solve a specific problem on a short term basis.
Anyone tried mob-programming? How did it work out?
|
|
|
|
|
R. Giskard Reventlov wrote: Anyone tried mob-programming? How did it work out?
Work out?, you seriously expect it to work out?
|
|
|
|
|
It's like in Warhammer when the Orcs drive a battle wagon. You need at least three, two younger ones and an older, more experienced one. The older one drives while the other two fight over who gets to drive.
And red ones always are fasta.
The language is JavaScript. that of Mordor, which I will not utter here
This is Javascript. If you put big wheels and a racing stripe on a golf cart, it's still a f***ing golf cart.
"I don't know, extraterrestrial?"
"You mean like from space?"
"No, from Canada."
If software development were a circus, we would all be the clowns.
|
|
|
|
|
I'd be bored rigid.
Watching someone else type is one of the most tedious jobs on the planet.
I guess it would get entertaining when the 1TB fan types and the K&R devotee tries to tell him what he's doing wrong, and as for Mr var meeting the Hungarian namer I would have to bring popcorn. And bandages, obviously - but mostly popcorn.
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|