arc42 / faq.arc42.org-site Goto Github PK
View Code? Open in Web Editor NEWWebsite for arc42-faq, companion to docs.arc42.org-site
Home Page: https://faq.arc42.org
License: Other
Website for arc42-faq, companion to docs.arc42.org-site
Home Page: https://faq.arc42.org
License: Other
oops - this is a css issue...
to reproduce: make browser window (much!) smaller...
format of numbered list is broken
reason: the arc42.org is statically generated and the mail-server has to be "manually" maintained...
For higher automation, this should be removed (in all three sites) and replaced by [email protected]
for people without disqus-account - add a small contact form.
Idea: https://formspree.io/
Shouldn't we add the C4 approach by simon brown to the building blocks?
C4 = context, containers, components, classes
IMHO, if you are not experienced with the building blocks, this approach is really helpful -
level1 = context
level2 = containers (deployment units like .wars and .jars, filesystems, databases)
level3 = components
level4 = classes
maybe redirect from index.html to "Home.md" page...
proposal:
[ ] remove submodule
[ ] commit & push version without submodule
[ ] re-include submodule with branch "main" instead of master
although I see them in local preview...
analog docs...
so we have stable targets for hyperlinks...
I think we should write something about the difference between SA4D and arc42.
I see the main difference that arc42 need no code and can be used to describe a software architecture independent of code. SA4D builds on the assumption that the needed architecture diagrams can be extracted from the code - it does not plan the architecture, but documents it.
As a result, both approaches might be used together: arc42 for planning and SA4D in a later stage for checking that reality and plans are the same. From that point on, SA4D could generate the diagrams for arc42.
Please correct me if I got it wrong...
need to find a simple way to cross-reference, both locally and on the "real" website!
@gernotstarke Please check if the footer with the "supported by INNOQ"-SVG is okay like this.
Shall I put it on other pages as well like this? On which pages?
Or do you want any changes?
https://github.com/rdmueller/arc42-faq-site/blob/master/_posts/C-arc42/2016-03-01-q-c-1-3.md
I would add something saying that arc42 is also a documentation - if someone else has to work with the architecture, he will be glad to already have a list of all stakeholder he could approach.
A: No, but it would make sense to reference it and distill the architecture requirements from it.
Those architecture requirements should be part of your arc42 documentation.
Some of the overall requirements are unimportant for the architecture, like the color scheme of the application. Others contain hidden architectural decisions. So it is your task to distill these architectonically important requirements and only reference the overall requirements.
explain how to approach documentation of existing systems
Comments on every page - "disqus" is the best-known system:
PRO
CON:
or redirect to Home.html...
index.html seems to be required...
in both docs and faq
strange behavior - does not occur when "jekyll serve" locally...
an issue with _config.yaml??
disqus comments are currently missing ...
are the keywords ok:
summarize slack discussion with @rdmueller
see .../faq/category_f/ for an example:
in principle, sorting works, but:
F-01, F1, F-10 get mixed up...
despite several experiments, no idea why the build fails with "include file subtle-ads.html not found".
crazy :-)
simply add "®" to the product names.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.