How to document a software

Question

i work with fotnet technology to develop web and windows application. so i like to know what would be the best approach to document a software when we develop with dotnet technology. what are the approaches taken by mid and big software house to document a software what they develop. please guys share your suggestion and recomendation. thanks

Fabio Silva Lima · Answer

Hello! You can enable this in your project properties, build tab: This will generate xml help files with your documentation and you can use other plugins and softwares to read those xml files and generate a PDF documentation. https://msdn.microsoft.com/pt-br/library/x4sa0ak0(v=vs.100).aspx

Fabio Silva Lima · Answer

Hello how are you doing? So, the first question is? What kind of documentation? User interface, technical stuff, installation or all kind of documentation? If you want to document your code you can start using of visual studio built documentation with "comments" above methods, classes, variables and so on... open/close , check it out bellow. You can alse generate a DOC file with all those documentation. /// /// This method do something /// /// the client model interface to use as entry point /// returns a page public async Task SetEntrada(ICliente cliente) { _vm.NotifyLoadingIfUniqueId(cliente.ID); await ConsultarCliente(cliente.ID); if (_vm.Cliente.PossuiAgregado) { await ConsultarAgregado(cliente.Agregado); } return this ; }

tri_inn · Answer

you said "You can alse generate a DOC file with all those documentation." please tell me how to generate doc file from xml documentation from VS IDE ? what best format and practise exist to document a software because if any team member leave company without hand over his job then we can refer his doc format to understand the flow of his module ? how to document UI too. please answer for my 3 question in details. thanks