How to generate a documentation
Generating the documentation
As the first step, select the project, you'd like to get a documentation for.
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FhaGWEOiHgff9XhcrOyYo%252Fimage.png%3Falt%3Dmedia%26token%3D70656541-6ff2-423d-b9a9-d40d7b0d4a5d&width=768&dpr=4&quality=100&sign=7af309c7&sv=1)
Click on 'View project' to open the project in the SDA Project Viewer
Alternatively, you can also select a specific version:
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FqRHeqtdalok4Li9BdVKE%252Fimage.png%3Falt%3Dmedia%26token%3D71d8b9cc-0217-4ebc-abc1-fd769ced4aa8&width=768&dpr=4&quality=100&sign=dd0af8cd&sv=1)
In the Project Viewer, select any file, that is supported (as pointed out in the Overview):
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FEcopM4OTzLgzFSoAoDh3%252Fimage.png%3Falt%3Dmedia%26token%3Dda8a4394-b366-4589-a304-1e488b03f2d4&width=768&dpr=4&quality=100&sign=6d4f8bf8&sv=1)
Select the desired file and then click the 'Explain' button. Upon clicking, a progress bar will display the current status of the documentation generation process. You may navigate away from the page or close the browser; the documentation generation will continue in the background.
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FaLK5UUpaWYJbkL8Dhz2E%252Fimage.png%3Falt%3Dmedia%26token%3Daea0058f-c028-41e5-be73-9a33db157bfe&width=768&dpr=4&quality=100&sign=aa77fb74&sv=1)
Once the documentation has been generated, a window will open:
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252F9czl2v3e7FRBvZZGB8FW%252Fimage.png%3Falt%3Dmedia%26token%3D0e5201d8-43e0-4c1e-9f72-8485e7b6acda&width=768&dpr=4&quality=100&sign=5e35d168&sv=1)
DocuMode
By clicking on the "DocuMode" button on the top right, all the already generated documentations will be displayed inline, in the project viewer:
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FB4PBvXO9vAbDPcn8z6uk%252Fimage.png%3Falt%3Dmedia%26token%3D1f25e370-5dd2-4463-a0d7-d6f9156f2611&width=768&dpr=4&quality=100&sign=1790996d&sv=1)
PDF Export
You can download the generated documentation for each file bundled together as a PDF by clicking the PDF icon located at the top right of the interface.
Verbose and Summarized Documentation
Per default, the summarized documentation is selected. But if the user desires, they can also switch to the verbose version, that has a greater level of detail.
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FkVgUxMariqfAoMUkp7ZQ%252Fimage.png%3Falt%3Dmedia%26token%3D7b73f05e-cea6-4e00-b363-29558d7ff56c&width=768&dpr=4&quality=100&sign=be484b5a&sv=1)
This feature is also supported in the DocuMode. By clicking the arrow on the right-hand side of the DocuMode button, the user can select what level of detail they want to see.
![](https://docs.softwaredefinedautomation.io/~gitbook/image?url=https%3A%2F%2F1333643659-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FI1vlLD3TIqZwxCVtJDLU%252Fuploads%252FZ5WcHoLwe3zAe6lLA6md%252Fimage.png%3Falt%3Dmedia%26token%3D54176eb8-bed0-49af-bccc-a772dfe99b5d&width=768&dpr=4&quality=100&sign=dbf84f27&sv=1)
Last updated