|
Don't forget to document the environment.
Have they Imaged the development machine, is it a VM so they boot and go.
Can they even install all of the components and compile it.
Next up: 80/20 rule. 80% of the changes are caused by 20% of the system.
Think in terms of a few recent requested changes...
Next up: do you have a bug tracker tied to version control? If so, I would
consider adding contextual information to the old bugs to make clarifications.
I would RATHER you have them:
1) Know how to build/deploy the system
2) Know how to use Source Control/Bug tracker to learn from (so they keep using them BOTH)
3) Know if they have a potential issue: Document the NEVERS that many don't document...
4) The Coding Standards and Guidelines so they continue with Code Reviews!
After that, I think you can assume a professional can generate class diagrams on their own, with the tools they like (I don't usually bother), and they can spend the requisite time seeing the types of code changes made, and what requests were tied to them.
In stable systems it will be change requests. In new systems, it is usually bug fixes, or story implementation...
HTH!
|
|
|
|
|
|
Visio (Pro) can do all the diagrams listed; and then some. You can also combine, link, publish, etc.
"(I) am amazed to see myself here rather than there ... now rather than then".
― Blaise Pascal
|
|
|
|
|
My $0.02, I use Visio to document state diagrams (with a 1-1 correspondence between code and diagram in terms of states and transitions), and OneNote to document process of developing the code, leaving a trail of process and of how-to notes, documenting how to use a particular device etc.
Atle
|
|
|
|
|
|
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.
|
|
|
|
|
|