/srv/irclogs.ubuntu.com/2015/05/10/#ubuntu-doc.txt

ahoneybunpleia2: its clear its not a over night thing true but I don;t think the benefits could be over looked22:21
pleia2context: ahoneybun proposing that all documentation teams move to RST22:21
pleia2ahoneybun: I definitely see benefits :)22:21
pleia2it's just a lot of work22:22
ahoneybunplus I;m maining talking about online docs not deskop atm22:22
ahoneybun*mainly22:22
ahoneybun*desktop22:22
pleia2the desktop documents are online22:22
pleia2just like xubuntu docs, ubuntu desktop docs are built and the output is published online22:23
ahoneybunI see22:23
pleia2the help.ubuntu.com/community/ wiki is supplimental to that22:23
ahoneybunthen the way I'm talking about would reverse - online -> desktop22:23
* pleia2 needs to publish the xubuntu docs for 15.04 soon :\22:23
ahoneybunI saw that22:24
pleia2not really, I assume the RST files would still reside in bzr?22:24
pleia2and we don't want all the ubuntu wiki put into the official docs, that's a huge maintenance burden and ruins the whole point of an easy to contribute to wiki22:25
ahoneybunyou should be able to host them on LP22:25
ahoneybunthe core things really22:25
ahoneybunpleia2: https://drive.google.com/file/d/0B6zAAODZFwQ2SGJCQ1YxRE1IaUU/view?usp=sharing22:25
pleia2the core things are already in the desktop documentation22:25
pleia2anyway, just some thoughts, I'm happy to make time to discuss further (maybe a doc team agenda item?) or answer questions about what we use later22:27
* pleia2 needs to go do Sunday things now :)22:27
ahoneybunyes of course22:28
ahoneybunI'll come to that meeting if I can22:28
ahoneybunpleia2: https://drive.google.com/file/d/0B6zAAODZFwQ2SGJCQ1YxRE1IaUU/view?usp=sharing22:28
ahoneybunopps22:28
ahoneybunpleia2: http://imgur.com/PNm0oRX22:28
ahoneybunalso http://imgur.com/QbyFBVZ22:29
ahoneybunand I'll let you go lol22:29
pmatulisahoneybun: i already proposed we move the ubuntu server guide to RST (or some variation like Git RST/markdown) but no one wants to help so it's not going to get done.  and just the server guide is quite a task, even with using a conversion tool (such as pandoc)23:09
ahoneybunpmatulis: maybe if one project does and the others see the benefits23:10
ahoneybunit could convice them23:10
pmatulisahoneybun: i did some tests and all links, in all documents break, in addition to the fancy docbook references to internal pages/sections of the guide23:11
ahoneybunyea you would have to redo it all within the language23:11
pmatulisahoneybun: hint, start with the server guide, it's a more compact project and it does not have the constraints of the desktop docs (it's not a package)23:12
ahoneybunpmatulis: I started moving the kubuntu docs by hand and it looks pretty darn nice in RST23:12
ahoneybunbut gsliva makes a point that having one language would stop others to help since they might use another language like TeX23:13
pmatulisahoneybun: if you *really* want to help convert the server guide to non-XML (Git Markdown; my preference) then join the doc team (if not already) and come to our next meeting (first tuesday of every month)23:16
pmatulisahoneybun: and this is what i did a while ago: https://github.com/petermatulis/serverguide23:16
ahoneybunsee that look so pretty to me23:17
ahoneybunthat is RTS though23:17
ahoneybunso the next meeting is June 2nd pmatulis?23:18

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