RE: Feedback request | Documentation site reorg, switch to Markdown

Hi Robert, Simon, Both very useful e-mails thanks. Robert: for unknown reasons (it is not in the held queue) your e-mails do not get to the docs e-mail list (or the translators one, I think), so this reply is also to get it there. Note: e-mails from some others are not getting to all copied

Re: Feedback request | Documentation site reorg, switch to Markdown

On Fri, Feb 24, 2017 at 2:22 PM, Chris Perry wrote: > Hi Peter > ... > > You used the term PITA (pain in the arse, I think). I (kind of) agree > with what you said about server guide xml being a PITA. All markup > languages are (kind of) a PITA. The problem I have with

Re: Feedback request | Documentation site reorg, switch to Markdown

On 02/27/2017 08:00 AM, Doug Smythies wrote: Very true, and a good point. Debugging some mistake is very very annoying and time consuming. In terms of warnings and error messages, I have no experience with the proposed Markdown method. Because it's made to look like plain-text, I do have to

Re: Feedback request | Documentation site reorg, switch to Markdown

Being part of a team that is now contributing on a weekly basis to docs.ubuntu.com/core, I can confidently mention that what we are doing with these contributions has been working out nicely. We have a use case of needing to contribute high quality documentation that is updated on a regular basis

RE: Feedback request | Documentation site reorg, switch to Markdown

On 2017.02.22 16:47 Peter Matulis wrote: > I should mention to the uninitiated that a single wayward character will > generate > a bewildering error when a build of HTML is attempted. Considering that you > need > to go through a long file full of the above stuff, I recall my "debugging" >

Re: Feedback request | Documentation site reorg, switch to Markdown

On Fri, Feb 24, 2017 at 7:22 AM, Chris Perry wrote: > > The problem I have with your proposal > is that (as far as I can see) you're moving from one PITA (server > guide xml) to another PITA (Markdown). > > How so? Peter -- ubuntu-translators mailing list

Re: Feedback request | Documentation site reorg, switch to Markdown

On Thu, Feb 23, 2017 at 3:03 PM, Matthew Paul Thomas wrote: > Peter Matulis wrote on 23/02/17 00:03: > > > > The idea is to improve upon what we have, not to achieve perfection. > > For sure. Imperfection is not my claim. My claim is that it would be > worse than what we

Re: Feedback request | Documentation site reorg, switch to Markdown

Peter Matulis wrote on 23/02/17 00:03: > > On Mon, Feb 20, 2017 at 1:58 PM, Matthew Paul Thomas … >> First, inconsistency. Moving documents to docs.ubuntu.com makes it >> practically impossible to achieve consistent design, because >> docs.ubuntu.com has a different look and

Re: Feedback request | Documentation site reorg, switch to Markdown

On Thu, Feb 16, 2017 at 8:46 AM, Jeremy Bicha wrote: Hi Jeremy. It's good to hear from you. I'm guessing that the new format will work fine for the Server Guide. > This means a lot coming from someone who did a lot of work maintaining the Server Guide in the past. > But

Re: Feedback request | Documentation site reorg, switch to Markdown

On Thu, Feb 16, 2017 at 8:25 AM, Stephen M. Webb wrote: Switching from a semantic documentation markup to a non-semantic > unstructured set of HTML macros that has wretched > support for anything other than web pages is a net negative gain. Markdown > was written by

Re: Feedback request | Documentation site reorg, switch to Markdown

On Mon, Feb 20, 2017 at 5:14 PM, Chris Perry wrote: I've never worked on the server guide until today but it was > straightforward for me to set it up, do a simple edit to one of the > xml files > Yes, I know it's simple to do a simple edit. Seriously though, I've

Re: Feedback request | Documentation site reorg, switch to Markdown

On Mon, Feb 20, 2017 at 1:58 PM, Matthew Paul Thomas wrote: > Peter Matulis wrote on 15/02/17 21:58: > >… > > There is a proposal put forward by Canonical to provide a consistent > > look and feel for all Ubuntu documentation, regardless of whether it > > is primarily

Re: Feedback request | Documentation site reorg, switch to Markdown

Peter Matulis wrote on 15/02/17 21:58: >… > There is a proposal put forward by Canonical to provide a consistent > look and feel for all Ubuntu documentation, regardless of whether it > is primarily maintained by the Community or by Canonical. The idea is > that this will provide a better user

Re: Feedback request | Documentation site reorg, switch to Markdown

Op 20-02-17 om 16:02 schreef Louis Bouchard: Hello, Le 20/02/2017 à 12:29, Chris Perry a écrit : Hi Peter It sounds as if you and Doug agree that the main problem here - by far the most important problem? - (as regards the server guide) is that "the Serverguide is in desperate need of subject

Re: Feedback request | Documentation site reorg, switch to Markdown

Hello, Le 20/02/2017 à 12:29, Chris Perry a écrit : > Hi Peter > > It sounds as if you and Doug agree that the main problem here - by far > the most important problem? - (as regards the server guide) is that > "the Serverguide is in desperate need of subject matter expert help". > Your proposal

Re: Feedback request | Documentation site reorg, switch to Markdown

On Sun, Feb 19, 2017 at 07:38:13PM -0500, Peter Matulis wrote: > As for the Installation Guide, it could benefit from being part of the > family. I'll inquire into the feasibility of converting it. The installation guide is substantially based on Debian's; it's been a little while since it was

Re: Feedback request | Documentation site reorg, switch to Markdown

On Sun, Feb 19, 2017 at 2:25 PM, Doug Smythies wrote: > On 2017.02.15 13:58 Peter Matulis wrote: > >> All this would entail: >> >> - Initial conversion of all XML files to GFM (GitHub Flavored >> Markdown) [1]. Done by Canonical. >> >> Canonical could create a mockup site of

RE: Feedback request | Documentation site reorg, switch to Markdown

Hi Peter, I'm only commenting on the Ubuntu Serverguide herein, As others have covered the desktop help docs and the installation guide quite well. What I have to say was also covered in our off-list pre-discussion. On 2017.02.15 13:58 Peter Matulis wrote: > All this would entail: > > -

RE: Feedback request | Documentation site reorg, switch to Markdown

Hi Robert, Thanks very much for chiming in. On 2017.02.18 15:30 Robert Young wrote: > Hi all, > > As a person interested in contributing for the first time, Do you know which area you are most likely to contribute to? The desktop help or the serverguide or the installation guide or all 3? >

Re: Feedback request | Documentation site reorg, switch to Markdown

[ Replying to the lists I'm subscribed to. Now when the topic has been announced to multiple lists, I would suggest that the following discussion is hold on one list, and I suggest ubuntu-doc for the purpose. ] Hi Peter, There are three sets of docs at help.ubuntu.com: * installation guide *

Re: Feedback request | Documentation site reorg, switch to Markdown

On Thu, Feb 16, 2017 at 8:25 AM, Stephen M. Webb wrote: > Switching from a semantic documentation markup to a non-semantic unstructured > set of HTML macros that has wretched > support for anything other than web pages is a net negative gain. Markdown > was written

Re: Feedback request | Documentation site reorg, switch to Markdown

On 2017-02-16 07:42 AM, Chris Perry wrote: > > I'm a newish volunteer so perhaps I can be trusted to give a new > volunteer's opinion of Markdown. To me it's just a markup language. If > I'm writing or revising a numbered list or creating a section heading > or creating a table, etc, it makes

Re: Feedback request | Documentation site reorg, switch to Markdown

> On Wed, Feb 15, 2017 at 4:58 PM, Peter Matulis > wrote: > > For help.ubuntu.com, each help topic (Server, Desktop, and > Installation Guide) would get their own page (e.g. > docs.ubuntu.com/server). help.u.c would continue to exist solely for > the help wiki, which

Re: Feedback request | Documentation site reorg, switch to Markdown

To reach a wide audience on this matter I sent to a few mailing lists. Apologies in advance for any collateral damage this may cause. Peter On Wed, Feb 15, 2017 at 4:58 PM, Peter Matulis wrote: > All, > > This is a request for feedback from the community. > > There

Feedback request | Documentation site reorg, switch to Markdown

All, This is a request for feedback from the community. There is a proposal put forward by Canonical to provide a consistent look and feel for all Ubuntu documentation, regardless of whether it is primarily maintained by the Community or by Canonical. The idea is that this will provide a better