{"guid":"38775ee6-c151-4cc6-974c-4d121f95b159","title":"Documentation with any editor","subtitle":null,"slug":"froscon2019-2389-documentation_with_any_editor","link":"https://programm.froscon.de/2019/events/2389.html","description":"Creating documentation is often boring and needs a lot of copy\u0026paste to update the different output formats. I'll show you my workflow creating textbased documentation with asciidoctor and convert it through a pipeline to html, pdf and some more formats.\n\nCreating professional documentation with asciidoctor and some other opensource tools, using the editor of your choice. I create a pipeline (Jenkins or Gitlab CI/CD) to convert a simple ascii text to any documentation format. So when your project needs  html that's fine, when your customer needs some PDF and you want to use your company logo that's nearly the same. You can create multiple outputs from one source, update screenshots automatically and still edit it on any of your devices or editors. Using a pipeline and containers after commiting to a version control system can be used on any operating system, or directly in the cloud. So there is nothing between you and your documentation.","original_language":"eng","persons":["Christoph Stoettner"],"view_count":758,"promoted":false,"date":"2019-08-11T00:00:00.000+02:00","release_date":"2019-08-12T02:00:00.000+02:00","updated_at":"2026-03-23T23:30:05.936+01:00","tags":["froscon2019","2389","System Administration"],"length":3277,"duration":3277,"thumb_url":"https://static.media.ccc.de/media/events/froscon/2019/2389-hd.jpg","poster_url":"https://static.media.ccc.de/media/events/froscon/2019/2389-hd_preview.jpg","timeline_url":"https://static.media.ccc.de/media/events/froscon/2019/2389-hd.timeline.jpg","thumbnails_url":"https://static.media.ccc.de/media/events/froscon/2019/2389-hd.thumbnails.vtt","frontend_link":"https://media.ccc.de/v/froscon2019-2389-documentation_with_any_editor","url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_title":"FrOSCon 2019","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019","related":[{"event_id":7251,"event_guid":"b69c19ce-7c89-4afd-9396-ea664f80dba7 ","weight":16},{"event_id":7268,"event_guid":"7007a0ab-a90c-4c5a-8ff2-e9faa6eba646","weight":17},{"event_id":7278,"event_guid":"8f758bad-51ea-453a-9d97-6c97a614f2e4","weight":14},{"event_id":7279,"event_guid":"967fa2a1-265f-47c1-90b2-ec8dba08b328","weight":18},{"event_id":7281,"event_guid":"bb5b04bd-9599-4d93-bd12-c779f381cf5e","weight":25},{"event_id":7286,"event_guid":"a2f61e35-bf54-4cf9-9362-e4d04fa94915","weight":13},{"event_id":7287,"event_guid":"0ff8cbfa-b751-4107-beec-33a2678939d8","weight":18},{"event_id":7294,"event_guid":"e442db46-0a05-4439-9bcf-21bca6f714a0","weight":15},{"event_id":7295,"event_guid":"1804f134-5ee8-46ff-8ea0-279350304c2a","weight":24},{"event_id":7296,"event_guid":"b8424140-1639-44f7-a19a-67af58ad61e9","weight":25},{"event_id":7298,"event_guid":"f87f303a-5b65-4cfe-b4b6-54c8557e868e","weight":14},{"event_id":7308,"event_guid":"725bf5fc-26a0-468b-a1ee-c5e5e8154fd2","weight":11},{"event_id":7319,"event_guid":"d652dc05-fd17-4972-aaa3-5f678b2f7475","weight":15},{"event_id":7322,"event_guid":"37eebf57-a64d-4cc8-8ee1-226810ac834a","weight":25},{"event_id":7325,"event_guid":"9279d4b2-71f4-4b6a-8b65-d40cdeb75b1a","weight":1},{"event_id":7329,"event_guid":"9186fc88-b1f8-45fc-8dcb-a375e029680d","weight":15},{"event_id":7332,"event_guid":"50ad5991-1b2f-4a92-ba87-dec6456f085a","weight":42},{"event_id":7341,"event_guid":"7100ad0c-e4f3-4784-b707-46759cd3cb6a","weight":28},{"event_id":7343,"event_guid":"212468fa-72ee-4d11-a32e-56d5e6fd78a3","weight":8},{"event_id":7345,"event_guid":"a04f9f57-2046-4b50-b6da-4154bc0aa375","weight":11},{"event_id":7348,"event_guid":"d826f086-8ce2-4925-9dfa-b02db91c73ca","weight":32},{"event_id":7351,"event_guid":"ca5e5930-ca47-41c9-b85d-73475fb75edb","weight":4},{"event_id":7355,"event_guid":"a160f9d4-663b-4237-b56a-20d065ade180","weight":17},{"event_id":7381,"event_guid":"e988c76b-3a47-46de-a2c7-77c49a5e731b","weight":13}],"recordings":[{"size":251,"length":3277,"mime_type":"video/mp4","language":"eng","filename":"froscon2019-2389-eng-Documentation_with_any_editor_hd.mp4","state":"new","folder":"h264-hd","high_quality":true,"width":1920,"height":1080,"updated_at":"2019-08-12T23:04:19.365+02:00","recording_url":"https://cdn.media.ccc.de/events/froscon/2019/h264-hd/froscon2019-2389-eng-Documentation_with_any_editor_hd.mp4","url":"https://api.media.ccc.de/public/recordings/37146","event_url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019"},{"size":33,"length":3277,"mime_type":"audio/opus","language":"eng","filename":"froscon2019-2389-eng-Documentation_with_any_editor_opus.opus","state":"new","folder":"opus","high_quality":false,"width":0,"height":0,"updated_at":"2019-08-12T23:07:03.678+02:00","recording_url":"https://cdn.media.ccc.de/events/froscon/2019/opus/froscon2019-2389-eng-Documentation_with_any_editor_opus.opus","url":"https://api.media.ccc.de/public/recordings/37147","event_url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019"},{"size":50,"length":3277,"mime_type":"audio/mpeg","language":"eng","filename":"froscon2019-2389-eng-Documentation_with_any_editor_mp3.mp3","state":"new","folder":"mp3","high_quality":false,"width":0,"height":0,"updated_at":"2019-08-12T23:07:34.291+02:00","recording_url":"https://cdn.media.ccc.de/events/froscon/2019/mp3/froscon2019-2389-eng-Documentation_with_any_editor_mp3.mp3","url":"https://api.media.ccc.de/public/recordings/37148","event_url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019"},{"size":101,"length":3277,"mime_type":"video/mp4","language":"eng","filename":"froscon2019-2389-eng-Documentation_with_any_editor_sd.mp4","state":"new","folder":"h264-sd","high_quality":false,"width":720,"height":576,"updated_at":"2019-08-12T23:18:06.434+02:00","recording_url":"https://cdn.media.ccc.de/events/froscon/2019/h264-sd/froscon2019-2389-eng-Documentation_with_any_editor_sd.mp4","url":"https://api.media.ccc.de/public/recordings/37149","event_url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019"},{"size":155,"length":3277,"mime_type":"video/webm","language":"eng","filename":"froscon2019-2389-eng-Documentation_with_any_editor_webm-sd.webm","state":"new","folder":"webm-sd","high_quality":false,"width":720,"height":576,"updated_at":"2019-08-12T23:34:08.439+02:00","recording_url":"https://cdn.media.ccc.de/events/froscon/2019/webm-sd/froscon2019-2389-eng-Documentation_with_any_editor_webm-sd.webm","url":"https://api.media.ccc.de/public/recordings/37150","event_url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019"},{"size":432,"length":3277,"mime_type":"video/webm","language":"eng","filename":"froscon2019-2389-eng-Documentation_with_any_editor_webm-hd.webm","state":"new","folder":"webm-hd","high_quality":true,"width":1920,"height":1080,"updated_at":"2019-08-13T01:08:15.601+02:00","recording_url":"https://cdn.media.ccc.de/events/froscon/2019/webm-hd/froscon2019-2389-eng-Documentation_with_any_editor_webm-hd.webm","url":"https://api.media.ccc.de/public/recordings/37151","event_url":"https://api.media.ccc.de/public/events/38775ee6-c151-4cc6-974c-4d121f95b159","conference_url":"https://api.media.ccc.de/public/conferences/froscon2019"}]}