marttilaine

2 yıl öncediscuss

> When someone wants to contribute without understanding the code workflow, he should not contribute.

There are definitely many projects where you don't need to understand every single aspect of the codebase to be able to contribute a meaningful fix or even a feature.

It benefits the contributor and the project if they have a simple pointer to e.g. where the application logic code is, or where the distribution-related code is, etc.

marttilaine

2 yıl öncediscuss

I experimented with something similar in one of my larger side projects a couple of years ago:

https://github.com/shipmight/shipmight/blob/master/src/ARCHI...

At the top of each file there was a tree of links to other ARCHITECTURE.md-files in the repo, like this:

    * ARCHITECTURE.md <- you are here
    * backend/ARCHITECTURE.md
        * backend/api/ARCHITECTURE.md
        * backend/cli/ARCHITECTURE.md
        * backend/ui/ARCHITECTURE.md
        * backend/utils/ARCHITECTURE.md
    * frontend/ARCHITECTURE.md
    * internal-charts/ARCHITECTURE.md

marttilaine

2 yıl öncediscuss

For anyone struggling with Helm YAML syntax errors in their day job, I shamelessly advertise my browser-based debug tool Helm Playground:

https://helm-playground.com/ - https://github.com/shipmight/helm-playground

marttilaine

3 yıl öncediscuss

Thanks for the tip about Lucidchart line drawing, will check out how they do it.

What would you imagine as the optimal AI workflow? Iassume it's more complex than just issuing commands like "move AWS-section under Infrastructure"?

marttilaine

3 yıl öncediscuss

Yes, it's planned! My knowledge on distributing a Linux desktop app is a bit limited, but I plan to add .deb and .rpm releases soon.

marttilaine

3 yıl öncediscuss

There is potential to import and export DOT and e.g. Mermaid. Of course the editor functionality would be limited to what those formats support, and diagram layout would not be exported 1-to-1, as it's recalculated by the renderer of that format eventually. These are not on the immediate roadmap.

marttilaine

3 yıl öncediscuss

Hmm. Not able to reproduce this issue. Do you see the clipboard icon turning to checkmark on the second copy too? If not, then the browser blocked the second clipboard operation.

marttilaine

3 yıl öncediscuss

Thanks for reporting! Fixed.

marttilaine

3 yıl öncediscuss

Sorry about this, was an oversight. Should not do that anymore!

marttilaine

3 yıl öncediscuss

Thank you all for the feedback on this! I agree. It didn't seem like such an issue during development, but that was a misjudgement. Removed that functionality now. Should not add to history anymore (shareable URLs should still work).

marttilaine

3 yıl öncediscuss

As mentioned in the sidebar, this tool is inspired by https://shadows.brumm.af/

I've used it a lot, but it always lacked a few features I would've used extensively, such as shareable links, copying to Figma with a button click, ability to change the background color, and a library of ready-made shadows. Also, I think the terminology is perhaps a bit clearer for someone who hasn't looked deeply into how this layering technique works.

marttilaine

Submissions

Notes on the Physics of Startups by Rob Snyder [video]

Show HN: One API for LinkedIn, X, Slack, SMS, and email (yeetpost)

How does a "you interview for US company, we do the work" scam work?

Ask HN: Best tool for autonomous quick coding assessments?

Ask HN: What are your most common tasks and painpoints in spreadsheet software?

Show HN: Diagramming app for power users (Finegram)

I made a smooth shadows generator

comments