{"guid":"3137aeb4-795c-474f-826b-dd170fee1346","title":"Effizient arbeiten mit Architecture Decision Records (ADR)","subtitle":null,"slug":"bob2020-108-effizient_arbeiten_mit_architecture_decision_records_adr","link":"https://bobkonf.de/2020/dienst.html","description":"Dokumentation gehört oft nicht zu den\n\tLieblingsaufgaben im Softwareentwicklungsalltag. Das\n\tresultiert in vielen Fällen daraus, da nicht klar ist, warum\n\tetwas dokumentiert werden sollte. Der in der Praxis gelebte\n\tAnsatz einen Dokumentationsort, zum Beispiel in Form eines\n\tWikis, ist zum Scheitern verurteilt. Entweder es wird kaum\n\tdokumentiert oder zu viel und es wird schwer Informationen zu\n\tfinden, die man sucht.\n\n\tEin leichtgewichtiger Ansatz ist arc42, bei dem je nach Bedarf\n\tdie vorgegebenen Unterpunkte ausgefüllt werden. Dort werden im\n\tUnterpunkt neun Entwurfsentscheidungen dokumentiert, also\n\tgenau die Entscheidungen, die die Softwarearchitektur\n\tentscheidend prägen. Die Auswirkungen von nicht dokumentierten\n\tEntscheidungen gehen von immer wiederkehrenden Diskussionen,\n\tbis hin zu fehlerhaften Folgeentscheidungen die das Projekt\n\tzum Scheitern bringen können. Doch wie können viele\n\tEntscheidungen effizient und nachvollziehbar dokumentiert\n\twerden?\n\n\tIn diesem Vortrag wird ein kompaktes Format namens\n\tArchitecture Decision Records (ADR) vorgestellt und gezeigt,\n\twie sie effizient eingesetzt werden können. Neben\n\tKleinigkeiten wie der Titelvergabe für eine ADR wird ein\n\tLösungsvorschlag aufgezeigt, um bei einer großen Sammlung von\n\tEntwurfsentscheidungen (\u003e50) nicht den Überblick zu\n\tverlieren. Dabei kommt der Docs-As-Code Ansatz mit AsciiDoc\n\tund JBake zum Einsatz, mit dem die technische Architektur in\n\teiner Microsite gerendert wird. Durch Tagging und eine\n\teffiziente Suche, wird die Dokumentation nicht nur lebendig,\n\tsondern zum täglichen Arbeitsmittel.\n\t","original_language":"deu","persons":["Johannes Dienst"],"view_count":350,"promoted":false,"date":"2020-02-28T10:30:00.000+01:00","release_date":"2020-05-07T00:00:00.000+02:00","updated_at":"2025-09-29T15:00:11.642+02:00","tags":["bob2020","108","2020","Talk","BOB","BOBKonferenz"],"length":2762,"duration":2762,"thumb_url":"https://static.media.ccc.de/media/events/bobkonf/2020/108-hd.jpg","poster_url":"https://static.media.ccc.de/media/events/bobkonf/2020/108-hd_preview.jpg","timeline_url":"https://static.media.ccc.de/media/events/bobkonf/2020/108-hd.timeline.jpg","thumbnails_url":"https://static.media.ccc.de/media/events/bobkonf/2020/108-hd.thumbnails.vtt","frontend_link":"https://media.ccc.de/v/bob2020-108-effizient_arbeiten_mit_architecture_decision_records_adr","url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_title":"BOB Konferenz 2020","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020","related":[],"recordings":[{"size":117,"length":2762,"mime_type":"video/webm","language":"deu","filename":"bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_webm-sd.webm","state":"new","folder":"webm-sd","high_quality":false,"width":720,"height":576,"updated_at":"2020-05-07T11:46:46.240+02:00","recording_url":"https://cdn.media.ccc.de/events/bobkonf/2020/webm-sd/bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_webm-sd.webm","url":"https://api.media.ccc.de/public/recordings/47227","event_url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020"},{"size":184,"length":2762,"mime_type":"video/webm","language":"deu","filename":"bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_webm-hd.webm","state":"new","folder":"webm-hd","high_quality":true,"width":1280,"height":720,"updated_at":"2020-05-07T11:46:33.007+02:00","recording_url":"https://cdn.media.ccc.de/events/bobkonf/2020/webm-hd/bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_webm-hd.webm","url":"https://api.media.ccc.de/public/recordings/47225","event_url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020"},{"size":87,"length":2762,"mime_type":"video/mp4","language":"deu","filename":"bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_sd.mp4","state":"new","folder":"h264-sd","high_quality":false,"width":720,"height":576,"updated_at":"2020-05-07T11:09:41.946+02:00","recording_url":"https://cdn.media.ccc.de/events/bobkonf/2020/h264-sd/bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_sd.mp4","url":"https://api.media.ccc.de/public/recordings/47226","event_url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020"},{"size":150,"length":2762,"mime_type":"video/mp4","language":"deu","filename":"bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_hd.mp4","state":"new","folder":"h264-hd","high_quality":true,"width":1280,"height":720,"updated_at":"2020-05-07T11:03:16.913+02:00","recording_url":"https://cdn.media.ccc.de/events/bobkonf/2020/h264-hd/bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_hd.mp4","url":"https://api.media.ccc.de/public/recordings/47224","event_url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020"},{"size":29,"length":2762,"mime_type":"audio/opus","language":"deu","filename":"bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_opus.opus","state":"new","folder":"opus","high_quality":false,"width":0,"height":0,"updated_at":"2020-05-07T11:09:22.116+02:00","recording_url":"https://cdn.media.ccc.de/events/bobkonf/2020/opus/bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_opus.opus","url":"https://api.media.ccc.de/public/recordings/47245","event_url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020"},{"size":42,"length":2762,"mime_type":"audio/mpeg","language":"deu","filename":"bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_mp3.mp3","state":"new","folder":"mp3","high_quality":false,"width":0,"height":0,"updated_at":"2020-05-07T11:09:07.192+02:00","recording_url":"https://cdn.media.ccc.de/events/bobkonf/2020/mp3/bob2020-108-deu-Effizient_arbeiten_mit_Architecture_Decision_Records_ADR_mp3.mp3","url":"https://api.media.ccc.de/public/recordings/47243","event_url":"https://api.media.ccc.de/public/events/3137aeb4-795c-474f-826b-dd170fee1346","conference_url":"https://api.media.ccc.de/public/conferences/bobkonf2020"}]}