digitalmars.D.learn - DScanner warns class is undocumented, how to resolve it ?
- Vinod K Chandran (3/3) May 13 2020 Hi all,
- Vinod K Chandran (3/6) May 13 2020 Never mind, i found the answer myself. Just like in dot net, i
- Dennis (4/11) May 14 2020 If you plan to publish your code to dub, consider actually
- Vinod K Chandran (2/15) May 14 2020 Thanks for the reply. :)
- Vinod K Chandran (3/16) May 19 2020 Thanks. But i am not using dub because my code only runs with
- Cogitri (12/19) May 14 2020 Also see https://dlang.org/spec/ddoc.html for more info on DDoc.
- Vinod K Chandran (2/16) May 14 2020 Thanks for VS Code settings. Will add it to my VS Code.
Hi all, I wrote a class and in VS Code, DScanner says that the class is undocumented. How can i document a class ?
May 13 2020
On Thursday, 14 May 2020 at 06:05:00 UTC, Vinod K Chandran wrote:Hi all, I wrote a class and in VS Code, DScanner says that the class is undocumented. How can i document a class ?Never mind, i found the answer myself. Just like in dot net, i added triple forward slash comment and problem solved.
May 13 2020
On Thursday, 14 May 2020 at 06:08:17 UTC, Vinod K Chandran wrote:On Thursday, 14 May 2020 at 06:05:00 UTC, Vinod K Chandran wrote:If you plan to publish your code to dub, consider actually documenting it or marking it private/package so it won't appear as an undocumented symbol.Hi all, I wrote a class and in VS Code, DScanner says that the class is undocumented. How can i document a class ?Never mind, i found the answer myself. Just like in dot net, i added triple forward slash comment and problem solved.
May 14 2020
On Thursday, 14 May 2020 at 08:02:28 UTC, Dennis wrote:On Thursday, 14 May 2020 at 06:08:17 UTC, Vinod K Chandran wrote:Thanks for the reply. :)On Thursday, 14 May 2020 at 06:05:00 UTC, Vinod K Chandran wrote:If you plan to publish your code to dub, consider actually documenting it or marking it private/package so it won't appear as an undocumented symbol.Hi all, I wrote a class and in VS Code, DScanner says that the class is undocumented. How can i document a class ?Never mind, i found the answer myself. Just like in dot net, i added triple forward slash comment and problem solved.
May 14 2020
On Thursday, 14 May 2020 at 08:02:28 UTC, Dennis wrote:On Thursday, 14 May 2020 at 06:08:17 UTC, Vinod K Chandran wrote:Thanks. But i am not using dub because my code only runs with "dmd -i".On Thursday, 14 May 2020 at 06:05:00 UTC, Vinod K Chandran wrote:If you plan to publish your code to dub, consider actually documenting it or marking it private/package so it won't appear as an undocumented symbol.Hi all, I wrote a class and in VS Code, DScanner says that the class is undocumented. How can i document a class ?Never mind, i found the answer myself. Just like in dot net, i added triple forward slash comment and problem solved.
May 19 2020
On Thursday, 14 May 2020 at 06:08:17 UTC, Vinod K Chandran wrote:On Thursday, 14 May 2020 at 06:05:00 UTC, Vinod K Chandran wrote:Also see https://dlang.org/spec/ddoc.html for more info on DDoc. FWIW you can also disable the warning by adding the following to VSCode's settings.json: "dscanner.ignoredKeys": [ "dscanner.style.undocumented_declaration" ] to your settings.json. I do that since I usually find the warning distracting while implementing new methods, where I only document things once I'm happy with the implementation and all the warnings about missing docs usually distract me from more important warnings during that phase.Hi all, I wrote a class and in VS Code, DScanner says that the class is undocumented. How can i document a class ?Never mind, i found the answer myself. Just like in dot net, i added triple forward slash comment and problem solved.
May 14 2020
On Thursday, 14 May 2020 at 11:25:48 UTC, Cogitri wrote:On Thursday, 14 May 2020 at 06:08:17 UTC, Vinod K Chandran wrote:Thanks for VS Code settings. Will add it to my VS Code.[...]Also see https://dlang.org/spec/ddoc.html for more info on DDoc. FWIW you can also disable the warning by adding the following to VSCode's settings.json: "dscanner.ignoredKeys": [ "dscanner.style.undocumented_declaration" ] to your settings.json. I do that since I usually find the warning distracting while implementing new methods, where I only document things once I'm happy with the implementation and all the warnings about missing docs usually distract me from more important warnings during that phase.
May 14 2020