JUG Noord

📍 Location: ING Leeuwarden, Hazel: Reviusstraat 2, 8913 HT Leeuwarden

🚨 This is the new ING office, a 5 minute walk from the old one so keep that in mind while traveling. For those arriving by car: paid parking is available next door, or at Fonteinland or next to the WTC.🚨

🚨 Important: Signing up is mandatory for entry. If the name on your Meetup profile does not match your ID, please contact Johan (organizer) with your full name.

🇬🇧 From Legacy REST to OpenAPI: documenting existing APIs the smart way by Sijtsche Smeman (Get There)
Did you ever wish all your REST API's had a specification and a well-documented interface? In the earlier days of REST no specification did exist yet. In the later years there was Swagger.
You may have a landscape of undocumented services or they possibly even lack some checks. But how would you know without digging down in the code?
Remember the old days where you had a WSDL for SOAP endpoints? Today we have OpenAPI for REST interfaces.
In my current project at DUO we needed OpenAPI specifications for our existing applications. And they are quite easy to create. In this journey I'll show you how to document your existing REST endpoints with an OpenAPI specification and even make your application use it.

🇬🇧 Creating effective and objective architectural decision records (ADRs) by Piet van Dongen (OpenValue)
Documenting decisions is like eating your veggies as a kid: they keep telling you it’s good for you, but you just hate doing it. Architectural Decision Records (ADRs) to the rescue! ADRs are perfect for just-in-time, just-enough documentation for engineering teams and organizations.

During this session, you will learn how to make architectural decisions effectively and objectively by:

- Learning the structure of a good ADR (no more walls of text that nobody reads anyway!)
- Practicing how to turn subjective choices into objective ones (no more pros and cons lists and tribal conflicts!)
- Creating editable diagrams, fast (no more spending hours wrestling tools that your collaborators don’t know how to use!)
- Collaborating quickly with technical and non-technical stakeholders (no more hours of Tower of Babel meetings!)
- Reporting the decision using effective language and fit-for-audience diagrams (no more writing reports that end up unread in drawers!)

Do you want to learn how to facilitate good decision making without spending weeks looking for consent?

Then join this session and you will walk away a better software architecture decision facilitator.

About the speakers
Sijtsche Smeman is a Java developer with 25 years of experience in Java. She has been a freelancer for 18 years and is now working for Get There.
While she mostly works on backend projects, her coordination skills often make her combine programming with coordinating tasks like being a scrum master or leading projects. She has set herself the goal to become more proficient in public speaking.

Piet van Dongen is a senior software architect and engineering consultant at OpenValue, helping organizations solve complex technology challenges through effective software practices. With expertise spanning architecture, engineering, and education, he delivers practical solutions focused on resilient architectures and short development cycles. Known for his calm demeanor under pressure and strategic use of humor, Piet has guided clients through large-scale transformations, trained architects and engineers, and built an extensive professional network across the European tech community as organizer of the Dutch iSAQB Software Architecture Community and former leader of the Dutch AWS User Group.

A regular speaker at international conferences including AWS re:Invent, DevOpsDays, Codemotion, and Devoxx, Piet shares insights on effective software architecture practices, cloud migrations, and resilience engineering, with a blend of technical depth and engaging humor. His pragmatic approach combines technical expertise with business acumen, enabling teams to successfully adopt modern software architecture and engineering practices and DevOps methodologies. Whether consulting, speaking, or training, Piet partners with organizations to deliver tangible value and navigate their software delivery journeys with confidence.