Karel
Module documentation preview in development
I am trying to improve development experience when documenting Deno modules. What I would like to achieve ideally is to have a real-time preview of a module documentation close to what is generated on deno.land/x so that I can make sure that the documentation for my modules is spot on. Is there a way to do that?
I was experimenting with
deno doc command, but it does not support watch mode. I guess that the easiest solution with the current tooling would be to run deno doc --html whenever a code changes, and serve the resulting html using some live-server that would check for changes as well. Not a great solution.
Next, I was looking into https://github.com/denoland/docland and use the deno_doc package in combination with Fresh to get automatic refresh of the documentation. I was not able to make this work though since I am using some npm references and the deno_docis not able to load that using the default loader.
Does anyone have a better solution how to achieve good DX for documenting code?3 replies
Best hardware for Deno development?
I am looking for a new laptop / desktop for Deno development as my current setup seems no longer viable (to my big surprise). I have ThinkPad X1 with Intel Core i7 CPU @ 2.40GHz, 8GB RAM, fast SSD drive and Windows 10 Pro. I am using VS Code for development, and even if I just run one instance of VS Code and Chrome alongside it (e.g. to develop Fresh apps), I am hitting memory and CPU limits and the developer experience is terrible, as the LSP responses lag significantly. I have the system pretty optimized and do not have any bloatware installed that could negatively affect the available resources, yet the development of Deno apps is not great. With every change in code, the CPU consumption skyrockets and the whole VS Code feels laggy for a couple of seconds. My system is pretty old, but still the specs are not that bad, considering that I am just building lightweight apps. I've also used the same system for Android, .NET and Node.js development in the past without issues.
I do not have a preference regarding OS, I have worked with Win/Mac/Linux in the past. What I want is a machine that will allow me to have snappy auto-complete in VS Code and will not force me to constantly keep an eye on memory and CPU consumption. What would you recommend? Budget is of no concern, I really just want the best tool. Thank you!
9 replies