Hacker Newsnew | past | comments | ask | show | jobs | submit | zorg42's commentslogin

apply the established idea of "one-page documentation" to software architecture.


All of the arc42 documentation is written in English, and the template itself is available in seven different languages.

See, e.g., https://docs.arc42.org

Apart from one of the founders (me) being German, it's no "German thing", but hopefully helpful to all kinds of systems.


Tx, good to know.


a small gallery of (ai-generated) images showing different art styles.


A collection of Yoda portraits, purely generated by various AI systems.


I would have liked a few diagrams describing some of your ideas, structures or internal processes, instead of using only text.


That's a fair point. I tend to think in prose rather than visually, so I don't have diagrams already, but it would have been a good idea to put together graphical things to go along with the post to make it a better explanation! Good suggestion. Are there drawings or diagrams that you think would have been particularly useful?


QuickTime can record a window... low computational overhead, and built-in.


Also when you move or resize the window? Or can you just set the fixed frame for screen recording to a selected window's initial frame?


Can it? File / New screen recording just gets me the same cmd+shift+5 interface.


"capture selected window" or just press space


But that’s just a screenshot. You can’t do that with video right?


With both.. it's the same interface


You can't record _videos_ of a specific window though. You can only record a fixed region of the screen or the whole screen. "Capture selected window" only deals with screenshots, not with video.


alternatively, head over to the extensive documentation site(s):

https://docs.arc42.org and https://faq.arc42.org

both are free to use and hosted on public repos on Github.


Right you are, it's definitely not new.

arc42 has been used in practice since 2004. The newest version 8.0 has been released Febr. 2022.

We incorporated user feedback (plus our own experience in real-time, embedded, data warehouse and e-commerce systems)..

(I'm one of the authors of arc42)


arc42 is NOT part of the iSAQB Foundation curriculum. Depending on trainers, it might be covered within iSAQB trainings. If you are interested, you should check with your preferred training organisation in advance.

(I'm the author of arc42, so I'm biased).


SysML (like UML) is a diagramming/modeling notation. Neither of them proposes any high-level structure for documentation.

arc42 proposes ONLY a high-level documentation/communicatin structure, and is notation agnostic: I've often used it with UML, and with informal box-and-lines diagrams.


Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: