User Tools

Site Tools


kb:bestpractices:documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
kb:bestpractices:documentation [2024/07/02 14:49] – joerg.hampelkb:bestpractices:documentation [2025/05/19 14:59] (current) – manuel.sebald
Line 6: Line 6:
  
 {{indexmenu>:kb:bestpractices:documentation#1|tsort nsort}} {{indexmenu>:kb:bestpractices:documentation#1|tsort nsort}}
 +
 +---- 
 +
 +<WRAP center round tip 100%>
 +**For generating documentation from your LabVIEW code, make sure to check out the [[kb:labview-toolkits:antidoc|Antidoc Toolkit]].**
 +</WRAP>
 +
 +---- 
 +
 +===== Project Documentation =====
 +
 +Project specific documentation shall be included in the Git repository under the folder ''/Documentation''. Subfolders can be used to distinguish between documentation types, e.g. auto-generated code documentation, code architecture, ULM diagrams etc.
 +
 +
 +==== Tooling ====
 +
 +For all types of diagrams, we use the free and for all platforms available tool [[https://www.drawio.com/|daraw.io]]. It can be used directly from the Browser, or as a desktop app. Link to the most recent version: https://get.diagrams.net/.
 +
 +Online tools that work in the cloud (e.g. Canva, MS365, ...) shall be avoided because of security and confidentially issues. 
 +
 +<WRAP center round note important 100%>
 +**Do not store confidential customer data in untrusted cloud services!**
 +</WRAP>
 +
kb/bestpractices/documentation.1719931772.txt.gz · Last modified: 2024/07/02 14:49 by joerg.hampel