| *** masakif has joined #openstack-doc | 00:01 | |
| *** jamesmcarthur has quit IRC | 00:08 | |
| *** sneakerhax has joined #openstack-doc | 00:50 | |
| *** sneakerhax has left #openstack-doc | 00:51 | |
| *** jamesmcarthur has joined #openstack-doc | 01:14 | |
| *** jamesmcarthur has quit IRC | 01:24 | |
| *** pcaruana has joined #openstack-doc | 04:06 | |
| *** pcaruana has quit IRC | 04:23 | |
| *** jamesmcarthur has joined #openstack-doc | 04:24 | |
| *** jamesmcarthur has quit IRC | 04:29 | |
| *** pcaruana has joined #openstack-doc | 05:51 | |
| *** kopecmartin|off is now known as kopecmartin|rove | 06:54 | |
| *** tosky__ has joined #openstack-doc | 06:54 | |
| openstackgerrit | OpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata https://review.openstack.org/606892 | 07:29 |
|---|---|---|
| *** Emine has joined #openstack-doc | 07:29 | |
| *** d0ugal has joined #openstack-doc | 07:52 | |
| openstackgerrit | Merged openstack/openstack-manuals master: Imported Translations from Zanata https://review.openstack.org/606892 | 08:00 |
| *** kopecmartin|rove is now known as kopecmartin|ruck | 08:06 | |
| *** finucannot is now known as stephenfin | 08:43 | |
| *** tosky has joined #openstack-doc | 08:43 | |
| *** tosky__ has quit IRC | 08:44 | |
| *** masakif has quit IRC | 09:02 | |
| *** jamesmcarthur has joined #openstack-doc | 10:25 | |
| *** jamesmcarthur has quit IRC | 10:29 | |
| *** tpsilva has joined #openstack-doc | 11:41 | |
| *** pkovar has joined #openstack-doc | 11:46 | |
| openstackgerrit | Andriy Shevchenko proposed openstack/training-labs master: Removed older version of python added 3.5 https://review.openstack.org/606425 | 12:13 |
| *** jamesmcarthur has joined #openstack-doc | 12:27 | |
| *** jamesmcarthur has quit IRC | 12:35 | |
| *** Emine has quit IRC | 12:38 | |
| *** Emine has joined #openstack-doc | 12:52 | |
| *** dustins has joined #openstack-doc | 12:56 | |
| *** Emine has quit IRC | 12:59 | |
| *** jamesmcarthur has joined #openstack-doc | 12:59 | |
| *** jamesmcarthur has quit IRC | 13:15 | |
| *** Emine has joined #openstack-doc | 13:17 | |
| *** jamesmcarthur has joined #openstack-doc | 13:36 | |
| *** jamesmcarthur has quit IRC | 13:37 | |
| *** jamesmcarthur has joined #openstack-doc | 13:38 | |
| *** tasker has joined #openstack-doc | 14:33 | |
| tasker | what procees and programs are used to format and keep your documents up-to-date with respect to features added in new version of various OpenStack components? | 14:34 |
| stephenfin | tasker: What kind of features are you talking about? | 14:43 |
| stephenfin | We used reno.sphinxext, oslo_config.sphinxext and oslo_policy.sphinxext to ensure our release note, configuration and policy documentation is generated dynamically (and therefore up-to-date) each time we build documentation | 14:44 |
| stephenfin | Oh, and sphinxcontrib-apidoc to do the same for Python API documentation. os_api_ref is used to build API documentation but that must be written by hand. | 14:45 |
| tasker | I presume that your content is a separate process / pipeline from the design of formatting and layout of the pages as seen. I'm new to documentation and trying to get an idea of some procedures on how to maintain some without getting hung-up on details. | 14:47 |
| AJaeger | tasker: this is done by individual teams in their own repos now - with their own ways | 14:49 |
| stephenfin | tasker: Ah, gotcha. Yeah, as AJaeger says, it's done on a per-team basis. In general though, we use Sphinx with the HTML build | 14:50 |
| AJaeger | stephenfin: do you know why os-api-ref is broken? See https://review.openstack.org/606690 | 14:50 |
| tasker | not really either yet.. .) I'm working to lay the groundwork for future documentation here at my company. | 14:50 |
| stephenfin | tasker: I'd take a look at Sphinx, if that's the case. That's what's used for all the upstream documentation | 14:51 |
| stephenfin | tasker: We (Red Hat) use asciidoc downstream but I think that's for legacy reasons. Not sure what other companies (Canonical, SUSE, et al) use. Sphinx is a good all-round option though, IMO | 14:52 |
| stephenfin | AJaeger: I wasn't aware of that. Let me take a look | 14:52 |
| AJaeger | stephenfin: might be newer packages? pbr failed also surprisingly - in neither case I had a quick fix ;( | 14:56 |
| AJaeger | stephenfin: thanks for checking | 14:56 |
| tasker | thanks for the input! | 15:05 |
| *** ttx has left #openstack-doc | 15:16 | |
| *** pcaruana has quit IRC | 15:30 | |
| *** tasker has quit IRC | 15:31 | |
| *** jamesmcarthur has quit IRC | 15:49 | |
| *** jamesmcarthur has joined #openstack-doc | 15:51 | |
| *** kopecmartin|ruck is now known as kopecmartin|off | 16:19 | |
| *** jamesmcarthur has quit IRC | 16:34 | |
| *** d0ugal has quit IRC | 16:54 | |
| *** pcaruana has joined #openstack-doc | 16:56 | |
| *** jamesmcarthur has joined #openstack-doc | 17:04 | |
| *** pkovar has quit IRC | 17:10 | |
| *** KeithMnemonic has joined #openstack-doc | 17:19 | |
| *** tosky has quit IRC | 17:33 | |
| *** diablo_rojo has joined #openstack-doc | 18:34 | |
| *** jamesmcarthur has quit IRC | 18:58 | |
| *** diablo_rojo has quit IRC | 19:08 | |
| *** tosky has joined #openstack-doc | 19:09 | |
| *** diablo_rojo has joined #openstack-doc | 19:14 | |
| *** jamesmcarthur has joined #openstack-doc | 19:38 | |
| *** diablo_rojo has quit IRC | 20:24 | |
| *** pcaruana has quit IRC | 20:43 | |
| *** diablo_rojo has joined #openstack-doc | 21:03 | |
| *** jamesmcarthur has quit IRC | 21:30 | |
| *** dustins has quit IRC | 21:51 | |
| *** jamesmcarthur has joined #openstack-doc | 21:55 | |
| *** jamesmcarthur has quit IRC | 21:59 | |
| *** jamesmcarthur has joined #openstack-doc | 22:03 | |
| *** threestrands has joined #openstack-doc | 22:41 | |
| *** jamesmcarthur has quit IRC | 22:42 | |
| *** tosky has quit IRC | 22:43 | |
| *** jamesmcarthur has joined #openstack-doc | 22:44 | |
| *** jamesmcarthur has quit IRC | 22:46 | |
| *** jamesmcarthur has joined #openstack-doc | 22:48 | |
| *** rcernin has joined #openstack-doc | 22:49 | |
| *** tpsilva has quit IRC | 22:50 | |
| *** jamesmcarthur has quit IRC | 22:55 | |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!