truthy

joined 1 year ago
[–] truthy@programming.dev 2 points 1 year ago

It's worth noting that the article is from December 2021, making it 1½ years old.

[–] truthy@programming.dev 11 points 1 year ago* (last edited 1 year ago) (1 children)

No, it's not cheating. But you are expected to understand what your code does and how.

And this brings us to the explanations it provides. Keep in mind that these AI tools excell in producing content that seems right. But they may very well be hallucinating. And just as for code, small details and exact concepts matter.

I would therefore recommend you to verify your final code against official documentation, to make sure you actually understand.

In the end, as long as you don't trust the AI, neither for solutions or knowledge, its just another tool. Use it as it fits.

[–] truthy@programming.dev 2 points 1 year ago

I've used C4 in different ways.

Using Structurizr Lite (docker): I do really like the "as code" aspect. The DSL is okay, the documentation of it not so much. But in the end, the tooling is too limited, and I've never come to terms with it. The diagrams becomes very locked in, and are cumbersome to export.

I'm not a fan of integrating SaaS solutions into the documentation workflow, but would really suggest that in favor of the Lite offering. Although I haven't used it.

Using C4 with ordinary tools: What I've come to use more, is using the conepts (and templates when available) with other, non-specialized tools. With Miro for example (there are templates). While not as cool as the "as code" way, it's an nice and accessible way of visualizing software systems.