ahoneybun | pleia2: its clear its not a over night thing true but I don;t think the benefits could be over looked | 22:21 |
---|---|---|
pleia2 | context: ahoneybun proposing that all documentation teams move to RST | 22:21 |
pleia2 | ahoneybun: I definitely see benefits :) | 22:21 |
pleia2 | it's just a lot of work | 22:22 |
ahoneybun | plus I;m maining talking about online docs not deskop atm | 22:22 |
ahoneybun | *mainly | 22:22 |
ahoneybun | *desktop | 22:22 |
pleia2 | the desktop documents are online | 22:22 |
pleia2 | just like xubuntu docs, ubuntu desktop docs are built and the output is published online | 22:23 |
ahoneybun | I see | 22:23 |
pleia2 | the help.ubuntu.com/community/ wiki is supplimental to that | 22:23 |
ahoneybun | then the way I'm talking about would reverse - online -> desktop | 22:23 |
* pleia2 needs to publish the xubuntu docs for 15.04 soon :\ | 22:23 | |
ahoneybun | I saw that | 22:24 |
pleia2 | not really, I assume the RST files would still reside in bzr? | 22:24 |
pleia2 | and 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 wiki | 22:25 |
ahoneybun | you should be able to host them on LP | 22:25 |
ahoneybun | the core things really | 22:25 |
ahoneybun | pleia2: https://drive.google.com/file/d/0B6zAAODZFwQ2SGJCQ1YxRE1IaUU/view?usp=sharing | 22:25 |
pleia2 | the core things are already in the desktop documentation | 22:25 |
pleia2 | anyway, 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 later | 22:27 |
* pleia2 needs to go do Sunday things now :) | 22:27 | |
ahoneybun | yes of course | 22:28 |
ahoneybun | I'll come to that meeting if I can | 22:28 |
ahoneybun | pleia2: https://drive.google.com/file/d/0B6zAAODZFwQ2SGJCQ1YxRE1IaUU/view?usp=sharing | 22:28 |
ahoneybun | opps | 22:28 |
ahoneybun | pleia2: http://imgur.com/PNm0oRX | 22:28 |
ahoneybun | also http://imgur.com/QbyFBVZ | 22:29 |
ahoneybun | and I'll let you go lol | 22:29 |
pmatulis | ahoneybun: 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 |
ahoneybun | pmatulis: maybe if one project does and the others see the benefits | 23:10 |
ahoneybun | it could convice them | 23:10 |
pmatulis | ahoneybun: i did some tests and all links, in all documents break, in addition to the fancy docbook references to internal pages/sections of the guide | 23:11 |
ahoneybun | yea you would have to redo it all within the language | 23:11 |
pmatulis | ahoneybun: 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 |
ahoneybun | pmatulis: I started moving the kubuntu docs by hand and it looks pretty darn nice in RST | 23:12 |
ahoneybun | but gsliva makes a point that having one language would stop others to help since they might use another language like TeX | 23:13 |
pmatulis | ahoneybun: 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 |
pmatulis | ahoneybun: and this is what i did a while ago: https://github.com/petermatulis/serverguide | 23:16 |
ahoneybun | see that look so pretty to me | 23:17 |
ahoneybun | that is RTS though | 23:17 |
ahoneybun | so the next meeting is June 2nd pmatulis? | 23:18 |
Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!