Monday, 2018-07-16

« Sunday, 2018-07-15 Index Tuesday, 2018-07-17 »
*** masaki has joined #openstack-doc00:01
*** suyog has quit IRC00:17
*** suyog has joined #openstack-doc00:31
*** krtaylor has joined #openstack-doc00:35
*** masaki has quit IRC01:36
*** dmacpher has joined #openstack-doc01:37
*** vijaykc4 has joined #openstack-doc03:55
*** vijaykc4 has quit IRC04:37
*** vijaykc4 has joined #openstack-doc04:45
*** vijaykc4 has quit IRC05:49
*** pcaruana has joined #openstack-doc06:36
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/58284006:57
*** peereb has joined #openstack-doc07:17
*** tesseract has joined #openstack-doc07:19
*** suyog has quit IRC07:28
*** tosky has joined #openstack-doc07:40
*** suyog has joined #openstack-doc07:41
*** suyog has quit IRC07:42
*** vijaykc4 has joined #openstack-doc07:54
*** dmacpher has quit IRC07:56
*** alexchadin has joined #openstack-doc08:03
*** pblaho has joined #openstack-doc08:07
openstackgerritMerged openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/58284008:51
*** edmondsw has joined #openstack-doc09:10
*** edmondsw has quit IRC09:15
*** vijaykc4 has quit IRC09:17
*** vijaykc4 has joined #openstack-doc09:18
*** vijaykc4 has quit IRC09:18
*** peereb has quit IRC09:19
*** vijaykc4 has joined #openstack-doc09:19
*** vijaykc4 has quit IRC09:20
*** dtantsur|afk is now known as dtantsur09:32
*** vijaykc4 has joined #openstack-doc10:08
*** alexchadin has quit IRC10:23
*** vijaykc4 has quit IRC10:32
*** dtantsur is now known as dtantsur|brb10:35
*** alexchadin has joined #openstack-doc10:56
*** edmondsw has joined #openstack-doc10:58
*** pkovar has joined #openstack-doc11:03
*** edmondsw has quit IRC11:03
*** rcernin has quit IRC11:45
*** edmondsw has joined #openstack-doc11:53
*** edmondsw has quit IRC11:56
*** dtantsur|brb is now known as dtantsur11:57
*** tpsilva has joined #openstack-doc12:26
*** edmondsw has joined #openstack-doc12:34
*** edmondsw has quit IRC12:39
*** dustins has joined #openstack-doc12:48
*** edmondsw has joined #openstack-doc13:04
*** pblaho has quit IRC13:13
*** vijaykc4 has joined #openstack-doc13:21
*** alex_xu has quit IRC13:29
*** alex_xu has joined #openstack-doc13:32
toskyit looks like user guides are only for services, at least looking at http://git.openstack.org/cgit/openstack/openstack-manuals/tree/tools/www-generator.py#n16813:33
AJaegertosky: why do you ask?13:34
toskybut we just added an user guide to python-tempestconf, which is not a service (I guess, unless I missed the difference between service and library)13:34
AJaegertosky: that would be developer documentation, not user (end user!)13:35
toskythere are two patches landing, but more or less the structure is https://docs.openstack.org/python-tempestconf/latest/13:35
toskyuhm13:35
AJaegertosky: we link to the user guides, see https://docs.openstack.org/queens/user/13:35
toskywhat we have now in the user documentation is the reference for a CLI guide13:35
toskyanother patch is adding other details more useful for developers13:36
*** gpocentek has joined #openstack-doc13:36
AJaegertosky: you can have those for sure - but we're just not going to list them on the page.13:37
toskyuhm13:37
toskyI would say then that this page should be fixed13:38
toskyhttps://docs.openstack.org/queens/language-bindings.html13:38
toskyinside " Use the dashboard and command-line clients ", "OpenStack End User Guide" redirects to the user pages which don't include CLI clients or dashboards13:39
AJaegertosky: https://review.openstack.org/#/c/582904/3/doc/source/user/import.rst fits into language-bindings.html   IMHO13:40
AJaegertosky: yes, that section could use a rework ;(13:40
toskyI would not know how to add something there (https://docs.openstack.org/queens/language-bindings.html)13:41
toskyuh, almost manually filled13:42
AJaegerthe left column not - but the right one indeed13:43
pkovarwe would need a designer to have a proper look at how to rework d.o.o pages so they are not just a wall of links13:45
pkovarwe used to have available in the past...13:45
pkovar* one13:45
pkovaras a quick fix, should we just replace "OpenStack End User Guide" with a link to dashboard?13:46
pkovaror just remove the link altogether?13:47
toskyuhm13:48
AJaegerpkovar: remove it - it'S dead ;(13:48
pkovarokay13:48
*** openstackgerrit has quit IRC14:04
*** vijaykc4 has quit IRC14:08
*** openstackgerrit has joined #openstack-doc14:08
openstackgerritPetr Kovar proposed openstack/openstack-manuals master: [www] Remove outdated link to end-user guide  https://review.openstack.org/58296114:08
pkovarAJaeger: tosky fix is up ^14:08
toskyoki14:09
toskybut anyway, I will have to rethink/review the tempestconf doc14:09
toskyor at least see if it's possible to add the links to its guides $somewhere14:10
pkovartosky: i would like to get your input on https://review.openstack.org/#/c/579177/14:11
toskyoh, I've seen that; I like the idea very much. I didn't go into a deep analysis of the structure, a quick check seems fine, but I didn't think too much about the various options14:11
toskyone thing is that this is targeted to services14:12
toskywhile the spec says " across all OpenStack project team documentation hosted on docs.openstack.org.", then it reads14:13
toskyOpenStack {{service name}} ({{codename}}) documentation14:13
pkovartosky: good point, could you leave a super quick comment please? :)14:13
toskyI will do; another comment14:14
toskyI'm not sure about  As a contributor to {{codename}}, get started with... Learn more about... - what it is going to be added there?14:14
toskybecause it may end up being a duplication of what it's in the guide14:14
toskymaybe there could be just a generic link to the main contributor guide14:14
toskygoing to comment14:14
pkovaryeah i know, i was thinking about an intro paragraph that could start like that14:15
pkovarfollowed by links14:15
*** jamesmcarthur has joined #openstack-doc14:24
*** jamesmcarthur has quit IRC14:46
toskyanother question: is or was there some effort to extract the api-ref documentation from comments directly, instead of having it separately?14:57
*** pcaruana has quit IRC15:02
*** jamesmcarthur has joined #openstack-doc15:06
pkovari am not aware of any such current effort15:09
toskybut was it ever raised?  Maybe the question is more: was ever tried and dismissed?15:10
tosky(so not to spend useless effort)15:11
AJaegertosky: sdague created the api-ref work, I don't know whether he tried something else. You would need to dig in old archives of openstack-dev and IRC. I don't remember anything.15:12
*** pblaho has joined #openstack-doc15:18
toskyok, thanks!15:20
*** d0ugal has quit IRC15:41
*** d0ugal has joined #openstack-doc15:41
*** d0ugal has quit IRC15:41
*** d0ugal has joined #openstack-doc15:41
*** alexchadin has quit IRC15:54
*** d0ugal has quit IRC16:03
*** d0ugal has joined #openstack-doc16:11
*** tesseract has quit IRC16:43
*** dtantsur is now known as dtantsur|afk16:44
*** d0ugal has quit IRC16:52
*** jamesmcarthur has quit IRC16:52
*** jamesmcarthur has joined #openstack-doc16:53
*** pkovar has quit IRC17:04
*** d0ugal has joined #openstack-doc17:05
*** jamesmcarthur has quit IRC17:19
*** jamesmcarthur has joined #openstack-doc17:20
*** jamesmcarthur has quit IRC17:24
*** jamesmcarthur has joined #openstack-doc17:33
*** jamesmcarthur has quit IRC17:34
*** jamesmca_ has joined #openstack-doc17:34
*** jamesmca_ has quit IRC17:42
*** jamesmcarthur has joined #openstack-doc17:42
*** jamesmcarthur has quit IRC17:45
*** jamesmcarthur has joined #openstack-doc17:49
*** d0ugal has quit IRC18:04
*** diablo_rojo has joined #openstack-doc18:05
*** d0ugal has joined #openstack-doc18:16
*** KeithMnemonic has joined #openstack-doc18:28
*** KeithMnemonic has quit IRC18:29
*** KeitMnemonic has joined #openstack-doc18:31
*** KeithMnemonic has joined #openstack-doc18:39
*** KeithMnemonic has quit IRC18:40
*** d0ugal has quit IRC18:46
*** jamesmcarthur has quit IRC18:48
*** d0ugal has joined #openstack-doc18:49
*** jamesmcarthur has joined #openstack-doc18:50
*** jamesmcarthur has quit IRC18:54
*** KeitMnemonic has quit IRC19:00
*** KeithMnemonic has joined #openstack-doc19:01
*** d0ugal has quit IRC19:02
*** d0ugal has joined #openstack-doc19:04
*** diablo_rojo has quit IRC19:21
*** KeithMnemonic has quit IRC19:57
*** kberger has joined #openstack-doc19:57
*** jamesmcarthur has joined #openstack-doc20:03
*** d0ugal has quit IRC20:16
*** d0ugal has joined #openstack-doc20:21
*** diablo_rojo has joined #openstack-doc20:33
*** d0ugal has quit IRC20:34
*** d0ugal has joined #openstack-doc20:46
*** jamesmcarthur has quit IRC20:50
*** jamesmcarthur has joined #openstack-doc20:54
*** jamesmcarthur has quit IRC21:21
*** dustins has quit IRC21:38
*** rcernin has joined #openstack-doc22:15
*** jamesmcarthur has joined #openstack-doc22:31
*** jamesmcarthur has quit IRC22:35
*** edmondsw has quit IRC22:43
*** edmondsw has joined #openstack-doc22:45
*** edmondsw has quit IRC22:50
*** rcernin has quit IRC22:54
*** jamesmcarthur has joined #openstack-doc22:55
*** rcernin has joined #openstack-doc23:08
*** jamesmcarthur has quit IRC23:10
*** jamesmcarthur has joined #openstack-doc23:11
*** tosky has quit IRC23:15
*** jamesmcarthur has quit IRC23:16
*** jamesmcarthur has joined #openstack-doc23:20
*** suyog has joined #openstack-doc23:30
*** tpsilva has quit IRC23:40
*** jamesmcarthur has quit IRC23:42
*** jamesmcarthur has joined #openstack-doc23:57
« Sunday, 2018-07-15 Index Tuesday, 2018-07-17 »

Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!