|
253 | 253 | leveraging our existing tools; this transformed how our team approached documentation |
254 | 254 | maintenance. What was once a burdensome manual process is now a streamlined, automated |
255 | 255 | part of every sprint cycle.</p>' |
256 | | -- title: Portable docs for data sovereignty |
257 | | - slug: portable-docs-for-data-sovereignty-val-grimm |
| 256 | +- title: Sovereign docs |
| 257 | + slug: sovereign-docs-val-grimm |
258 | 258 | series: Write the Docs Berlin |
259 | 259 | series_slug: berlin |
260 | 260 | year: 2025 |
|
263 | 263 | slug: val-grimm |
264 | 264 | twitter: |
265 | 265 | website: https://linkedin.com/in/vlgrimm |
266 | | - abstract: '<p>A portable documentation publishing approach is particularly relevant |
267 | | - right now because many organizations in Europe are interested in regaining their |
268 | | - digital sovereignty by transitioning away from technology solutions developed |
269 | | - and delivered outside of the EU. Our approach to portability does not fundamentally |
270 | | - rely on closed proprietary technologies or cloud platforms, although we used our |
271 | | - preferred tools to implement our solution. </p> |
272 | | -
|
273 | | - <p>We had a documentation publishing problem that a simple static site could not |
274 | | - solve. The platform we were creating for our customer consisted of multiple independent |
275 | | - components and was required to operate on a variety of cloud solutions, as well |
276 | | - as on-premises in air-gapped facilities. We also didn''t want activities related |
277 | | - to documentation to muddy the commit histories of our component repositories.</p> |
278 | | -
|
279 | | - <p>Our team solved these issues by approaching our documentation in the same way |
280 | | - as we did the rest of our platform: we delivered it as an independent containerized |
281 | | - component that we could deploy to all of our platforms in the same way as any |
282 | | - other application. </p> |
283 | | -
|
284 | | - <p>This talk is not a tutorial. It explains key concepts and provides an illustration |
285 | | - of how we applied a containerization approach to meet our needs.</p>' |
| 266 | + abstract: '<p>In reaction to a volatile environment, many organizations in Europe |
| 267 | + and around the world want to regain their data sovereignty to reduce geopolitical |
| 268 | + risk. </p> |
| 269 | +
|
| 270 | + <p>We had a complex publishing problem where we had to deliver our multi-module |
| 271 | + docs to a variety of cloud platforms and air-gapped on-premise installations. |
| 272 | + Our solution involved packaging our docs in containers. </p> |
| 273 | +
|
| 274 | + <p>Originally, I thought that other technical communicators would benefit most |
| 275 | + from learning about the architecture and implementation decisions we made. </p> |
| 276 | +
|
| 277 | + <p>More recently, I realized that the implications of our approach were far, far |
| 278 | + broader . . . and illuminated a path other organizations could follow toward |
| 279 | + docs sovereignty.</p>' |
286 | 280 | - title: 'What''s past is prologue: Write the Docs, communities, and organizing techcomm' |
287 | 281 | slug: what-s-past-is-prologue-write-the-docs-communities-and-organizing-techcomm-jennifer-rondeau |
288 | 282 | series: Write the Docs Berlin |
|
0 commit comments