Free developers from documentation

I come from an SAP Background where it is a requirement to create much documentation is designed to make sure everything is in place. It is not working optimally.

There are two types of documentation

1) Flow description: This is about giving other developers and idea of what was created and how they can maintain it.

2) Change documentation: Give away to trace why some feature was changed and the reason why

Both are important and need to be created.

"Good" developers always talk about: "My code is self-documenting", "If you cannot understand it, you are not a developer" Or "There are comments in the code."

I have not seen a developer that enjoyed the writing documentation. You should value the developers you have on your project and ensuring they can focus on the work. Then your project cost will go down.

For SAP Integration (SAP PI/PO and CPI) there has not really been a good way to document what you had created. It was just given some overall idea and then copied past a lot. Since the copy-paste does not add a lot of value it may be time to improve it.

Automation of Integration documentation

In SAP Integration we have been working to create tools that allow users to create documentation automatically. This speed up the process so they can focus on solving business needs instead of writing documentation.

The Figaf tool will be creating both types of documentation that you need for your project. So you will get a scenario view and a change log information.

Developers will need to write some documentation that cannot be automated, like what the flow is doing some things and the functions they are creating. But the overall process and flow are created automatically so it will be consistent.

You can read more about the tool at https://figaf.com/IRT