diff --git a/content/en/docs/project/onboarding/_index.md b/content/en/docs/project/onboarding/_index.md index d08ee3f..5525015 100644 --- a/content/en/docs/project/onboarding/_index.md +++ b/content/en/docs/project/onboarding/_index.md @@ -3,17 +3,37 @@ title: Onboarding [WiP] weight: 1 --- -You are new to DeveloperFramework subproject? You want to know about the context of 'Platfrom Engineering' and why we think it is the material we need to create the IPCEI-CIS Developer Framework? + + + +{{% blocks/lead color="dark" %}} +You are new to IPCEI-CIS subproject 'DeveloperFramework' ? + +You want to know about the context of 'Platform Engineering' and \ +why we think it's the stuff we need to create the DeveloperFramework? + So please feel free to read this Onboarding guide! +{{% /blocks/lead %}} + +## Project context ## Platforms +{{% pageinfo color="info" %}} +Since 2010 we have DevOps. This brings increasing delivery speed and efficiency at scale. +Next we got high cognitive loads for developers. +So we need on top of DevOps an instrumentation to ensure and enforce speed, quality, security in modern, cloud native software development. +{{% /pageinfo %}} + + ## History https://platformengineering.org/blog/the-story-of-platform-engineering ![alt text](image-1.png) +https://martinfowler.com/articles/talk-about-platforms.html + https://developers.redhat.com/articles/2024/05/06/what-platform-engineering-and-why-do-we-need-it#why_we_need_platform_engineering https://orkohunter.net/blog/a-brief-history-of-platform-engineering diff --git a/content/en/docs/project/onboarding/assets/context.puml b/content/en/docs/project/onboarding/assets/context.puml new file mode 100644 index 0000000..f8e24ef --- /dev/null +++ b/content/en/docs/project/onboarding/assets/context.puml @@ -0,0 +1,16 @@ +@startuml +!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Dynamic.puml + +LAYOUT_WITH_LEGEND() + +ContainerDb(c4, "Database", "Relational Database Schema", "Stores user registration information, hashed authentication credentials, access logs, etc.") +Container(c1, "Single-Page Application", "JavaScript and Angular", "Provides all of the Internet banking functionality to customers via their web browser.") +Container_Boundary(b, "API Application") { + Component(c3, "Security Component", "Spring Bean", "Provides functionality Related to signing in, changing passwords, etc.") + Component(c2, "Sign In Controller", "Spring MVC Rest Controller", "Allows users to sign in to the Internet Banking System.") +} +Rel_R(c1, c2, "Submits credentials to", "JSON/HTTPS") +Rel(c2, c3, "Calls isAuthenticated() on") +Rel_R(c3, c4, "select * from users where username = ?", "JDBC") +@enduml + diff --git a/hugo.toml b/hugo.toml index a422160..29044f7 100644 --- a/hugo.toml +++ b/hugo.toml @@ -161,4 +161,17 @@ enable = false version = "10.9.0" [params.markmap] -enable = true \ No newline at end of file +enable = true + +[params.plantuml] +enable = true +theme = "default" + +# Set url to plantuml server +# default is http://www.plantuml.com/plantuml/svg/ +svg_image_url = "https://www.plantuml.com/plantuml/svg/" + +# By default the plantuml implementation uses tags to display UML diagrams. +# When svg is set to true, diagrams are displayed using tags, maintaining functionality like links e.g. +# default = false +svg = true \ No newline at end of file