--- title: "Algorithm Process Flow docs: 5 things to fix" description: Improve your algorithm process flow docs with these 5 essential fixes, ensuring clarity. Learn how to avoid common pitfalls for better documentation. image: https://riskinsights.com.au/hubfs/Algorithm%20Process%20Flow%20docs%205%20things%20to%20fix.png --- [Skip to content](https://riskinsights.com.au/blog/algorithm-process-flow-docs-5-things-to-fix#main-content) [![Risk Insights - Logo - (RGB, Horizontal, Small)](https://riskinsights.com.au/hs-fs/hubfs/Risk%20Insights%20-%20Logo%20-%20(RGB%2c%20Horizontal%2c%20Small).png?width=200&height=40&name=Risk%20Insights%20-%20Logo%20-%20(RGB%2c%20Horizontal%2c%20Small).png)](https://riskinsights.com.au) - [Articles](https://riskinsights.com.au/blog) - [Approach](https://riskinsights.com.au/approach) - [About](https://riskinsights.com.au/about) - [Contact](https://riskinsights.com.au/contact) Open main navigation Close main navigation - [Articles](https://riskinsights.com.au/blog) - [Approach](https://riskinsights.com.au/approach) - [About](https://riskinsights.com.au/about) - [Contact](https://riskinsights.com.au/contact) --- 20 Nov 2025 # Algorithm Process Flow docs: 5 things to fix ![Picture of Yusuf Moolla](https://riskinsights.com.au/hs-fs/hubfs/Yusuf_Moolla_Headshot-transformed.png?width=50&name=Yusuf_Moolla_Headshot-transformed.png) [Yusuf Moolla](https://riskinsights.com.au/blog/author/yusuf) Share: [linkedin-in icon](http://www.linkedin.com/shareArticle?mini=true&url=https://riskinsights.com.au/blog/algorithm-process-flow-docs-5-things-to-fix) [envelope icon](mailto:?body=https://riskinsights.com.au/blog/algorithm-process-flow-docs-5-things-to-fix) **TL;DR** • Process flow docs are one of the first things we look for when starting a review. • But they are rarely in good shape; here are 5 things to do to make them better.   Process flow docs are one of the very first things we look for when starting an algorithmic system review. Especially when in graphic form, they help us understand where data comes from, what happens to it, and how decisions are made. We can then see the scope of the system and where we need to focus initial efforts. Every once in a while there’s no docs at all. This is the extreme case. There’s usually something available, but we rarely get what we need. So we end up putting our own drawing together, and use it for the review and for the report. Here are five things we often come across that would be a good idea to fix: 1. **Piecemeal:** aspects of the system are documented, others are left out. Very common, especially when (like most systems), components are designed separately and then brought together, or workarounds are put in place later. 2. **Out of date:** surprisingly common. How often to update? At least once a year, if not more often. Even systems that we think aren’t changing will have some form of upstream change or platform change, etc. 3. **Too high level:** not enough detail to see where the potential gaps are. 4. **Too detailed:** no high-level view, it’s all code or technical detail. Can also be difficult to maintain. 5. **Words only:** sometimes there are no graphics or pictures. Not very common, but we see it often enough that it’s worth including here. Fixing only these 5 can move the needle a fair bit. There are a few other things that can also help. For a future article.   --- Disclaimer: The info in this article is not legal advice. It may not be relevant to your circumstances. It was written for specific contexts within banks and insurers, may not apply to other contexts, and may not be relevant to other types of organisations. ---     ## Related posts [![Curated Insight: what to keep on file for a model that affects customers](https://riskinsights.com.au/hs-fs/hubfs/Curated%20Insight%20What%20to%20keep%20on%20file%20for%20a%20model%20that%20affects%20customers.png?height=200&name=Curated%20Insight%20What%20to%20keep%20on%20file%20for%20a%20model%20that%20affects%20customers.png)](https://riskinsights.com.au/blog/curated-insight-what-to-keep-on-file-for-a-model-that-affects-customers) ## [Curated Insight: what to keep on file for a model that affects customers](https://riskinsights.com.au/blog/curated-insight-what-to-keep-on-file-for-a-model-that-affects-customers) 25 Jun 2026 When a customer disputes an automated decision, or a regulator asks how a model reached its... [Read more](https://riskinsights.com.au/blog/curated-insight-what-to-keep-on-file-for-a-model-that-affects-customers) [![Back view image of young businessperson trying to find way out of maze](https://riskinsights.com.au/hs-fs/hubfs/Back%20view%20image%20of%20young%20businessman%20trying%20to%20find%20way%20out%20of%20maze.jpeg?height=200&name=Back%20view%20image%20of%20young%20businessman%20trying%20to%20find%20way%20out%20of%20maze.jpeg)](https://riskinsights.com.au/blog/explainability-part-3-complicated-processes) ## [Algorithm Integrity: Explainability (Part 3) - Complicated Processes](https://riskinsights.com.au/blog/explainability-part-3-complicated-processes) 13 Mar 2025 TL;DR • Algorithmic processes are often complicated by intricate data flows and transformations. •... [Read more](https://riskinsights.com.au/blog/explainability-part-3-complicated-processes) [![businessman hand show book of word policy on texture background as concept](https://riskinsights.com.au/hs-fs/hubfs/businessman%20hand%20show%20book%20of%20word%20policy%20on%20texture%20background%20as%20concept.jpeg?height=200&name=businessman%20hand%20show%20book%20of%20word%20policy%20on%20texture%20background%20as%20concept.jpeg)](https://riskinsights.com.au/blog/documentation-starter) ## [Algorithm Integrity Documentation - Getting Started](https://riskinsights.com.au/blog/documentation-starter) 04 Dec 2024 TL;DR • Start with five key items: Algorithm Inventory; Risk Assessment; Policies (with Procedures,... [Read more](https://riskinsights.com.au/blog/documentation-starter) We acknowledge Aboriginal and Torres Strait Islander peoples as the Traditional Custodians of the lands on which we live and work. We pay our respects to Elders past and present, and honour the rich diversity of the world's oldest living cultures. [View our LinkedIn page](https://www.linkedin.com/company/riskinsightsap) [email us](mailto:info@riskinsights.com.au) [Call us](tel:+61408946143) 2026 Risk Insights Pty. Ltd. | [Privacy](https://riskinsights.com.au/privacy-policy) | [Disclaimer](https://riskinsights.com.au/disclaimer) ```json { "@context" : "https://schema.org", "@type" : "BlogPosting", "author" : { "@type" : "Person", "name" : "Yusuf Moolla", "url" : "https://riskinsights.com.au/blog/author/yusuf" }, "dateModified" : "2025-11-19T23:34:09.915Z", "datePublished" : "2025-11-19T23:33:58.000Z", "headline" : "Algorithm Process Flow docs: 5 things to fix", "image" : [ "https://riskinsights.com.au/hubfs/Algorithm%20Process%20Flow%20docs%205%20things%20to%20fix.png" ], "mainEntityOfPage" : { "@id" : "https://riskinsights.com.au/blog/algorithm-process-flow-docs-5-things-to-fix", "@type" : "WebPage" }, "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "url" : "https://riskinsights.com.au/hubfs/Risk%20Insights%20-%20Logo%20-%20(RGB%2c%20Horizontal%2c%20Small).png" }, "name" : "Risk Insights Pty. Ltd." } } ```