IBM / itaa-docs

Documentation for IBM IT Architect Assistant (all offerings)
Eclipse Public License 1.0
33 stars 27 forks source link

How do you integrate into current Dev streams #21

Open munapower opened 3 years ago

munapower commented 3 years ago

Considering that the documentation generated with this tool is considered System Documentation and in Agile it is recommended that it be included in the same versioning tool as the code .... is there some type of How-To to join ITAA with these tools, like Github?

glcraig commented 2 years ago

I think this raises the larger question regarding how the content will be consumed. ITAA (SaaS) offering has a direct export/load from Git functionality. It basically creates the archive file (zip of the workspace subfolder representing an architecture) and then pushes/loads from Git that archive file.
This then becomes a version archive. This is what would be recommended in your Dev stream scenario above. However, then everyone needs to understand that to "open" a build's version of the architecture involves loading that into the tool to then generate other document formats