As most of job scope of my previous job in BCSIS is to support the application, on my own I have created plenty of own version internal ‘software document’. I think some of these documents are mixed breed between process flow diagram and sequence diagram 🙂 Nevertheless, this is my favorite internal document as I can easily understand the flow of the system just by some quick glance. I also converted some source code into some flow chart diagrams (again my version).
In fact, I do enjoy and satisfying creating all these diagrams. And I did the same for my Product Management department as QC Manager in GHL. By the way, I just use Ms Power Point. No need expensive tool like Visio 🙂
Here are the entire list of ‘Process flow + Sequence’ diagram documents which I have created. Yes, the sample diagrams are a little ‘unclear’ for reasons. To view the ‘clear’ version and to view more diagrams, you can contact me personally ya.
After working for more than ten years in several positions particularly within Software Development Life Cycle (SDLC), I come to this observation – software documentation management is lacking in most companies. Thus, it hurts the company greatly at the end. One of the most important benefits of having sufficient, quality and manageable software documentation is to minimize RISK. Let me explain. From the early stages until the end of the SDLC, some documents supposed to be produced.
Imagine, which is a faster way for Wong to explain Mutu’s modules or for Sally to learn it? Reading 20, 000 lines of source code or looking at a some software documentation diagrams? Worst still these 20, 000 lines of ‘messy’ (i.e. with redundant similar functions or libraries) source code. Now wonder the employee turn over rate is high 🙂
Another beneficial reason of having proper software documentation like change request form and release notes document is to manage risk. I have seen some fire-fighting moments whereby the production system has so many bugs and unstable. Issues were escalated from one level to another level until the company had to hire a team of ‘specialist’ from oversea to cope and control the ‘fire’. So much money was spent.
At the end, the company decided to take so serious the importance of having proper process. Eventually new role was created just to focus on managing quality, process and risk and one way is by adopting Capability Maturity Model Integration (CMMI) Level 3 process model. After some months of learning CMMI, the ‘Process/Quality Manager’ then trained all roles which involve in SDLC, be it project manager, team leader, software engineer, software tester or application support engineer. It took a while to learn it. Initially, there were some complaints because of the hassle it caused. But, as time goes by, those process and template documents were refined to suit the need. Software engineers took longer time to release a fixes but what fixes released to the production system were much more stable than before. This is because the fixes were released and thoroughly tested by the software tester first before approve to be released to production environment.
Yesterday I just came back from a week vacation in Seoul, South Korea. Just like my Tokyo vacation last year, I will share some of my thoughts and my travelling cost to my reader’s benefits 🙂
I will start with my travelling cost. My total travelling cost is about RM3,000 and here are the breakdowns:
Air ticket (including return baggage)
Accommodation (6 nights)
Nanta “Cookin” Live Show
WIFI modem rental
I changed for 510,000 Korean Won (KRW), which is equal to about RM 2,000. After the trip, about 150,000 Korean Won remain. We traveled in a group of four. So we booked Airbnb for the whole unit which has 3 rooms.
Temperature for the week range from 8-20 degree Celsius (°C) which is not bad. Better than last year in Tokyo which hit 2°C at night which is freezing cold! My travel buddy David, the main planner, also checked weather forecast to make sure our whole week got not rain. Indeed that weather forecast 10 months ago came true, thankfully!
Main itinerary: Nami Island, Gangnam city bus tour (Lotte World Tower, Floating Islands, Samsung D’light), Gyeongbokgung Palace, Gwangjang market, Insadong, Itaewon, Myeongdong, N Seoul Tower, Namdaemun market, Nanta Cookin Live Performance, War Memorial of Korea and Hongdae (Hongik University Street).
Nami Island – I will post some photos first. Photo caption to be updated soon.
Google Express – The future of home delivery arrives today. From above. Google Express offers fast delivery of things you need from stores you love. With our new delivery technology, packages will arrive even faster
Gmail Blue – Fast. Beautiful. Powerful.
Gmail Tap – Tap into the future of productivity with Gmail Tap for Android and iOS. Double your typing speed with this revolutionary new keyboard.
Google Nose – We’re excited to announce our newest addition to Search: Google Nose. What do wet dogs smell like? Google Nose! How about victory? Google Nose! Try searching on Google for “wet dog” and explore other smells that people sniffed for, or visit google.com/nose to learn more. Happy smelling!
Gmail Motion – Now you can control Gmail with your body.
Dial-Up mode – The loading bar is a signal to many of us to take care of those little things- like making a cup of coffee, taking that bathroom break or just petting the dog. We have been told that Fiber’s seemingly instant connections have taken away that valuable time. So today we are introducing Dial-Up Mode to slow your Fiber speeds down. Relax to your 56k connection and get those precious moments back.
Next week, the Software Engineering one month course I am teaching will end. Overall, I am happy to see the progress of my students. They have improved much in their programming skills. Their assignment title is “Starbucks Simple Payroll System”. While they are doing their assignment, I also do a sample version for them. So, just to print screen some here.
Some sample documentation I created for students are reference: