Next Doc team meeting: Aug 6
Gunnar Hjalmarsson
gunnarhj at ubuntu.com
Thu Aug 7 19:45:43 UTC 2014
On 2014-08-07 20:39, Peter Matulis wrote:
> On 08/07/2014 02:18 PM, Gunnar Hjalmarsson wrote:
>> On 2014-08-07 20:00, Peter Matulis wrote:
>>> On 08/07/2014 01:41 PM, Gunnar Hjalmarsson wrote:
>>>> If you are talking about building the HTML and committing the pages to
>>>> lp:~ubuntu-core-doc/ubuntu-docs/help.ubuntu.com, I feel that's a task
>>>> which should be accomplished by someone who is quite familiar with the
>>>> docs related procedures.
>>>
>>> I'm talking about any changes that do not relate to documentation. That
>>> would be code changes and committing those changes to help.ubuntu.com .
>>
>> As far as I know, there is no such separation between "documentation"
>> and "code"; hence my doubts. Both the contents and the HTML markup are
>> created when building the HTML. Exceptions would be the few index pages,
>> which are edited directly in lp:~ubuntu-core-doc/ubuntu-docs/help.ubuntu.com
>
> There is a clear distinction between files pertaining to Ubuntu
> documentation and those pertaining to the look of a website.
Well, within the lp:ubuntu-docs and lp:serverguide branches there is, of
course.
> Wherever the latter changes need to be made is irrelevant to make that
> point
I don't think it's irrelevant. It sounds as if you want to establish
some rules as regards which files in the branches you as an
~ubuntu-core-doc member are allowed to edit and which files you are not.
I can't see how such rules would be helpful. Of course, members of
~ubuntu-core-doc are expected to only make changes as long as they know
what they are doing. Besides that, we don't need further restrictions IMO.
The html/ubuntu.xsl file in lp:ubuntu-docs is certainly controlling the
look of the web site. I have made (tiny) changes to it twice lately. But
please note that committing such changes to help.ubuntu.com is not a
separate process. You commit them by building the HTML pages and
committing those pages to lp:~ubuntu-core-doc/ubuntu-docs/help.ubuntu.com
> Do you also want to be included along with Doug?
I certainly want to keep being allowed to make changes as those I just
mentioned.
But you are probably referring to:
"It was decided that you, Doug, being the only one familiar with this,
will be the preferred party to update the website. If not done after a
grace period of 2 weeks then the Canonical web team will do it."
After this latest conversation, I understand the meaning of it even less
than before.
Peter: What problem is it you are trying to address? Can't help feeling
that "if it ain't broke, don't fix it" applies.
--
Gunnar Hjalmarsson
https://launchpad.net/~gunnarhj
More information about the ubuntu-doc
mailing list