New Ubuntu Server Guide Live

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
15 messages Options
Reply | Threaded
Open this post in threaded view
|

New Ubuntu Server Guide Live

Joshua Powers
Hi,

The new official home for the Ubuntu Server Guide is now live:

https://ubuntu.com/server/docs

On the bottom of each server guide page is a link to the specific
Discourse page that contains the raw content. Users can now more easily
make suggestions, point out errors, and fix bugs on pages. If a
discourse page is updated the change is reflected within seconds on
ubuntu.com.

Please continue to help revise the server guide with the latest
information as we prepare for the Focal Fossa release!

A PDF of the current version is coming soon.

Thanks,
Josh
--
Ubuntu Server
Canonical Ltd.

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
Hi Josh,

Thank you for getting the site up.
I'll add the note and link from
help.ubuntu.com

On 2019.11.19 09:32 Joshua Powers wrote:

> The new official home for the Ubuntu Server Guide is now live:
>
> https://ubuntu.com/server/docs
>
> On the bottom of each server guide page is a link to the specific
> Discourse page that contains the raw content. Users can now more easily
> make suggestions, point out errors, and fix bugs on pages. If a
> discourse page is updated the change is reflected within seconds on
> ubuntu.com.
>

What is the list of people that have sufficient rights to cause
an update to the published web pages?

I ask because this is a very restricted list [1] for help.ubuntu.com,
on purpose. Additionally, I almost always publish on my own web server
first, to check, and have others (typically Gunnar) check before going live.

I worry about the potential for abuse, while at the same time welcome the ease
of use.

Actually, I only see the edit button available me for some pages. Why is that?

> Please continue to help revise the server guide with the latest
> information as we prepare for the Focal Fossa release!
>
> A PDF of the current version is coming soon.

Great.

One of the reasons we were anxious to see the compiled and
published web pages was so that we could see if those internal
links that were "???" would get sorted out. They don't, so
that'll have to be figured out. Example:
The first paragraph of [2] the ??? is supposed to say this:
"Remote Administration"
And the link is supposed to be to ... huh? ...
Oh, that chapter cover section is gone. Oh!, maybe
that is why the link is busted (it just so happened
to be the first one I tried).

O.K. So I went to look at the edit I did under the virt-install page,
But it is gone. What the hell? I see some recent edits deleting
very very important stuff. Why? I wrote that stuff and want it to stay.

I guess I had better get a 20.04 server going so that I can test
that these thing still work or maybe got changed.

I'll be back at a later date.

[1] https://launchpad.net/~ubuntu-core-doc/+members#active
[2] https://ubuntu.com/server/docs/service-ftp
[3] ???

... Doug



--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: New Ubuntu Server Guide Live

Christian Ehrhardt
On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:

>
> Hi Josh,
>
> Thank you for getting the site up.
> I'll add the note and link from
> help.ubuntu.com
>
> On 2019.11.19 09:32 Joshua Powers wrote:
>
> > The new official home for the Ubuntu Server Guide is now live:
> >
> > https://ubuntu.com/server/docs
> >
> > On the bottom of each server guide page is a link to the specific
> > Discourse page that contains the raw content. Users can now more easily
> > make suggestions, point out errors, and fix bugs on pages. If a
> > discourse page is updated the change is reflected within seconds on
> > ubuntu.com.
> >
>
> What is the list of people that have sufficient rights to cause
> an update to the published web pages?
>
> I ask because this is a very restricted list [1] for help.ubuntu.com,
> on purpose. Additionally, I almost always publish on my own web server
> first, to check, and have others (typically Gunnar) check before going live.
>
> I worry about the potential for abuse, while at the same time welcome the ease
> of use.
>
> Actually, I only see the edit button available me for some pages. Why is that?
>
> > Please continue to help revise the server guide with the latest
> > information as we prepare for the Focal Fossa release!
> >
> > A PDF of the current version is coming soon.
>
> Great.
>
> One of the reasons we were anxious to see the compiled and
> published web pages was so that we could see if those internal
> links that were "???" would get sorted out. They don't, so
> that'll have to be figured out. Example:
> The first paragraph of [2] the ??? is supposed to say this:
> "Remote Administration"
> And the link is supposed to be to ... huh? ...
> Oh, that chapter cover section is gone. Oh!, maybe
> that is why the link is busted (it just so happened
> to be the first one I tried).
>
> O.K. So I went to look at the edit I did under the virt-install page,
> But it is gone. What the hell? I see some recent edits deleting
> very very important stuff. Why? I wrote that stuff and want it to stay.

HI Doug,
I can't answer the others but this one about virt-install I can.
In the context of being the libvirt page it was overflowing and hard
to find actual libvirt centric information.

First of all I have to admit that I do not like virt-inst too much
(but that is my personal problem I guess).
virt-install is only in universe but people tend to rely on it (too
much), causes continuous problems (silly/odd bug reports often come
from this area), and tends to get people not realizing the much more
consumable cloud images.
But nevertheless what you are missing isn't gone forever anyway.

I have a set of further todos here to go further in this cycles doc
update, that will probably:
- split out virtinst/virt-clone to an extra page (as it is an
alternative to uvtool / multipass that have extra pages as well)
  - There I plan to bring back that content that you are missing atm
- Split virt-manager / virt-viewer to their own page as well (then it
might have space for some screenshots)
- For the libvirt page itself there are other topics that much more
make sense there (not sure how much of them I'll get covered)
  - apparmor integration in libvirt and customizing it
  - huge page usage through libvirt
  - some extra content on passthrough
  - ... (those are aligned to questions/bug/mistakes) that I've seen
over the last years

> I guess I had better get a 20.04 server going so that I can test
> that these thing still work or maybe got changed.
>
> I'll be back at a later date.
>
> [1] https://launchpad.net/~ubuntu-core-doc/+members#active
> [2] https://ubuntu.com/server/docs/service-ftp
> [3] ???
>
> ... Doug
>
>
>
> --
> ubuntu-doc mailing list
> [hidden email]
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc



--
Christian Ehrhardt
Staff Engineer, Ubuntu Server
Canonical Ltd

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
On 2019.11.20 23:00 Christian Ehrhardt wrote:

> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
>> On 2019.11.19 09:32 Joshua Powers wrote:
>>
>>> The new official home for the Ubuntu Server Guide is now live:
>>>
>>> https://ubuntu.com/server/docs
>>>
>>> On the bottom of each server guide page is a link to the specific
>>> Discourse page that contains the raw content. Users can now more easily
>>> make suggestions, point out errors, and fix bugs on pages. If a
>>> discourse page is updated the change is reflected within seconds on
>>> ubuntu.com.
>>>
>>
>> What is the list of people that have sufficient rights to cause
>> an update to the published web pages?
>>
>> I ask because this is a very restricted list [1] for help.ubuntu.com,
>> on purpose. Additionally, I almost always publish on my own web server
>> first, to check, and have others (typically Gunnar) check before going live.
>>
>> I worry about the potential for abuse, while at the same time welcome the ease
>> of use.
>>
>> Actually, I only see the edit button available me for some pages. Why is that?
>>
>>> Please continue to help revise the server guide with the latest
>>> information as we prepare for the Focal Fossa release!
>>>
>>> A PDF of the current version is coming soon.
>>
>> Great.
>>
>> One of the reasons we were anxious to see the compiled and
>> published web pages was so that we could see if those internal
>> links that were "???" would get sorted out. They don't, so
>> that'll have to be figured out. Example:
>> The first paragraph of [2] the ??? is supposed to say this:
>> "Remote Administration"
>> And the link is supposed to be to ... huh? ...
>> Oh, that chapter cover section is gone. Oh!, maybe
>> that is why the link is busted (it just so happened
>> to be the first one I tried).
>>
>> O.K. So I went to look at the edit I did under the virt-install page,
>> But it is gone. What the hell? I see some recent edits deleting
>> very very important stuff. Why? I wrote that stuff and want it to stay.
>
> HI Doug,
> I can't answer the others but this one about virt-install I can.
> In the context of being the libvirt page it was overflowing and hard
> to find actual libvirt centric information.
>
> First of all I have to admit that I do not like virt-inst too much
> (but that is my personal problem I guess).
> virt-install is only in universe but people tend to rely on it (too
> much), causes continuous problems (silly/odd bug reports often come
> from this area), and tends to get people not realizing the much more
> consumable cloud images.
> But nevertheless what you are missing isn't gone forever anyway.

O.K. thanks for explaining.
For my part of it, the reason I like virt-install is because
it is a command line tool, and therefore good for a server, with no GUI.
I only use Ubuntu linux for servers.
(I do have desktop Ubuntu on some old computers and VMs, but just to help,
mainly Gunnar, with the desktop help publications at help.ubuntu.com)
Myself I have no interest in cloud and uvtool stuff.

> I have a set of further todos here to go further in this cycles doc
> update, that will probably:
> - split out virtinst/virt-clone to an extra page (as it is an
> alternative to uvtool / multipass that have extra pages as well)
>  - There I plan to bring back that content that you are missing atm

O.K. thanks for explaining.

> - Split virt-manager / virt-viewer to their own page as well (then it
> might have space for some screenshots)

These require a GUI.
Be careful with adding screenshots. Our doc-team experience has been that
they become a maintenance nightmare, requiring per cycle updating.
 
> - For the libvirt page itself there are other topics that much more
> make sense there (not sure how much of them I'll get covered)
>  - apparmor integration in libvirt and customizing it
>  - huge page usage through libvirt
>  - some extra content on passthrough

Extra passthrough content would be good. I see a lot of questions
about it on askubuntu.com and ubuntuforums.

>  - ... (those are aligned to questions/bug/mistakes) that I've seen
> over the last years

Thank for your contributions, past and present, to the serverguide.

... Doug



--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
On 2019.11.21 07:08 Doug Smythies wrote:

> On 2019.11.20 23:00 Christian Ehrhardt wrote:
>> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
>>> On 2019.11.19 09:32 Joshua Powers wrote:
>>>
>>>> The new official home for the Ubuntu Server Guide is now live:
>>>>
>>>> https://ubuntu.com/server/docs
>>>>
>>>> On the bottom of each server guide page is a link to the specific
>>>> Discourse page that contains the raw content. Users can now more easily
>>>> make suggestions, point out errors, and fix bugs on pages. If a
>>>> discourse page is updated the change is reflected within seconds on
>>>> ubuntu.com.
..,

>>> O.K. So I went to look at the edit I did under the virt-install page,
>>> But it is gone. What the hell? I see some recent edits deleting
>>> very very important stuff. Why? I wrote that stuff and want it to stay.
>>
>> HI Doug,
>> I can't answer the others but this one about virt-install I can.
>> In the context of being the libvirt page it was overflowing and hard
>> to find actual libvirt centric information.
>>
>> First of all I have to admit that I do not like virt-inst too much
>> (but that is my personal problem I guess).
>> virt-install is only in universe but people tend to rely on it (too
>> much), causes continuous problems (silly/odd bug reports often come
>> from this area), and tends to get people not realizing the much more
>> consumable cloud images.
>> But nevertheless what you are missing isn't gone forever anyway.
>
> O.K. thanks for explaining.
> For my part of it, the reason I like virt-install is because
> it is a command line tool, and therefore good for a server, with no GUI.
> I only use Ubuntu linux for servers.
> (I do have desktop Ubuntu on some old computers and VMs, but just to help,
> mainly Gunnar, with the desktop help publications at help.ubuntu.com)
> Myself I have no interest in cloud and uvtool stuff.
>
>> I have a set of further todos here to go further in this cycles doc
>> update, that will probably:
>> - split out virtinst/virt-clone to an extra page (as it is an
>> alternative to uvtool / multipass that have extra pages as well)
>>  - There I plan to bring back that content that you are missing atm
>
> O.K. thanks for explaining.

Currently, "virt-* tools" shows on the table of contents column,
but clicking the link goes to the source code page and not the
published page.

While I did not click every table of contents link, I did most,
and this was the only weird one.

I want to edit the virt-install example.

... Doug



--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: New Ubuntu Server Guide Live

Christian Ehrhardt
On Mon, Apr 20, 2020 at 4:58 PM Doug Smythies <[hidden email]> wrote:

>
> On 2019.11.21 07:08 Doug Smythies wrote:
> > On 2019.11.20 23:00 Christian Ehrhardt wrote:
> >> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
> >>> On 2019.11.19 09:32 Joshua Powers wrote:
> >>>
> >>>> The new official home for the Ubuntu Server Guide is now live:
> >>>>
> >>>> https://ubuntu.com/server/docs
> >>>>
> >>>> On the bottom of each server guide page is a link to the specific
> >>>> Discourse page that contains the raw content. Users can now more easily
> >>>> make suggestions, point out errors, and fix bugs on pages. If a
> >>>> discourse page is updated the change is reflected within seconds on
> >>>> ubuntu.com.
> ..,
>
> >>> O.K. So I went to look at the edit I did under the virt-install page,
> >>> But it is gone. What the hell? I see some recent edits deleting
> >>> very very important stuff. Why? I wrote that stuff and want it to stay.
> >>
> >> HI Doug,
> >> I can't answer the others but this one about virt-install I can.
> >> In the context of being the libvirt page it was overflowing and hard
> >> to find actual libvirt centric information.
> >>
> >> First of all I have to admit that I do not like virt-inst too much
> >> (but that is my personal problem I guess).
> >> virt-install is only in universe but people tend to rely on it (too
> >> much), causes continuous problems (silly/odd bug reports often come
> >> from this area), and tends to get people not realizing the much more
> >> consumable cloud images.
> >> But nevertheless what you are missing isn't gone forever anyway.
> >
> > O.K. thanks for explaining.
> > For my part of it, the reason I like virt-install is because
> > it is a command line tool, and therefore good for a server, with no GUI.
> > I only use Ubuntu linux for servers.
> > (I do have desktop Ubuntu on some old computers and VMs, but just to help,
> > mainly Gunnar, with the desktop help publications at help.ubuntu.com)
> > Myself I have no interest in cloud and uvtool stuff.
> >
> >> I have a set of further todos here to go further in this cycles doc
> >> update, that will probably:
> >> - split out virtinst/virt-clone to an extra page (as it is an
> >> alternative to uvtool / multipass that have extra pages as well)
> >>  - There I plan to bring back that content that you are missing atm
> >
> > O.K. thanks for explaining.
>
> Currently, "virt-* tools" shows on the table of contents column,
> but clicking the link goes to the source code page and not the
> published page.

Hi Doug,
I didn't change anything, but for me "virt-tools" on [1] lead to [2]
which is the published page.
I saw you already made the change to the page content that you wanted to make,
but did you (or someone else) already fix this link as well or might this be
depending on who (user/browser/...) looks at it?

[1]: https://ubuntu.com/server/docs
[2]: https://ubuntu.com/server/docs/virtualization-virt-tools


> While I did not click every table of contents link, I did most,
> and this was the only weird one.
>
> I want to edit the virt-install example.
>
> ... Doug
>
>


--
Christian Ehrhardt
Staff Engineer, Ubuntu Server
Canonical Ltd

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
On 2020.04.21 00:03 Christian Ehrhardt wrote:

> On Mon, Apr 20, 2020 at 4:58 PM Doug Smythies <[hidden email]> wrote:
>> On 2019.11.21 07:08 Doug Smythies wrote:
>>> On 2019.11.20 23:00 Christian Ehrhardt wrote:
>>>> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
>>>>> On 2019.11.19 09:32 Joshua Powers wrote:
>>
>> Currently, "virt-* tools" shows on the table of contents column,
>> but clicking the link goes to the source code page and not the
>> published page.
>
> Hi Doug,
> I didn't change anything, but for me "virt-tools" on [1] lead to [2]
> which is the published page.
> I saw you already made the change to the page content that you wanted to make,
> but did you (or someone else) already fix this link as well or might this be
> depending on who (user/browser/...) looks at it?
>

I attempted to fix the link last night my time, a few hours before your e-mail
time stamp.

I also had a conflict edit on that same page with Josh earlier yesterday, but
do not yet now how to look up revision histories on discourse so don't
know what he was doing.

I could not see my attempt to include that page at the time,
it still went to the discourse source page instead, but I
do see it this morning.
I wonder if a new html page needs time to actually create or something,
just like the PDF is only daily.

> [1]: https://ubuntu.com/server/docs
> [2]: https://ubuntu.com/server/docs/virtualization-virt-tools





--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: New Ubuntu Server Guide Live

Christian Ehrhardt
On Tue, Apr 21, 2020 at 4:31 PM Doug Smythies <[hidden email]> wrote:

>
> On 2020.04.21 00:03 Christian Ehrhardt wrote:
> > On Mon, Apr 20, 2020 at 4:58 PM Doug Smythies <[hidden email]> wrote:
> >> On 2019.11.21 07:08 Doug Smythies wrote:
> >>> On 2019.11.20 23:00 Christian Ehrhardt wrote:
> >>>> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
> >>>>> On 2019.11.19 09:32 Joshua Powers wrote:
> >>
> >> Currently, "virt-* tools" shows on the table of contents column,
> >> but clicking the link goes to the source code page and not the
> >> published page.
> >
> > Hi Doug,
> > I didn't change anything, but for me "virt-tools" on [1] lead to [2]
> > which is the published page.
> > I saw you already made the change to the page content that you wanted to make,
> > but did you (or someone else) already fix this link as well or might this be
> > depending on who (user/browser/...) looks at it?
> >
>
> I attempted to fix the link last night my time, a few hours before your e-mail
> time stamp.
>
> I also had a conflict edit on that same page with Josh earlier yesterday, but
> do not yet now how to look up revision histories on discourse so don't
> know what he was doing.

At the top of the post (if it is a wiki type as our guide posts are)
there is a little counter which shows the number of versions.
It is a Number followed by a "pen on a paper" icon.
That opens up the history and you can switch through versions.

For example I see you adding the self-link to "Introduction" as last edit.
Josh before did change "virt-* tools" to "virt tools" and so on.

> I could not see my attempt to include that page at the time,
> it still went to the discourse source page instead, but I
> do see it this morning.
> I wonder if a new html page needs time to actually create or something,
> just like the PDF is only daily.

IIRC html usually rendered sub 30 minutes for me, mostly almost instantly.
And that seems to be true as your [2] has your last changes.

I haven't checked the PDF in the past so I don't know what to estimate.

But I agree that there the whole section of virt-tools is missing.
PDF directly goes from uvt to lxd skipping virt-tools.
Maybe that is why Josh updated the link?

There might be something missing on the virt-tools page.
Other than the majority of pages around it it was created by me (a
split from other virt* pages).
I have added the tags to the page and links from the introduction to
finally confirm it was rendered into HTML.

But I never checked the PDF, maybe there is some other tweak yet
unknown to me needed to properly render it into PDF as well.
I'll ask around and let you know if I find anything.

> > [1]: https://ubuntu.com/server/docs
> > [2]: https://ubuntu.com/server/docs/virtualization-virt-tools
>
>
>
>

--
Christian Ehrhardt
Staff Engineer, Ubuntu Server
Canonical Ltd

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: New Ubuntu Server Guide Live

Christian Ehrhardt
On Wed, Apr 22, 2020 at 8:13 AM Christian Ehrhardt
<[hidden email]> wrote:

>
> On Tue, Apr 21, 2020 at 4:31 PM Doug Smythies <[hidden email]> wrote:
> >
> > On 2020.04.21 00:03 Christian Ehrhardt wrote:
> > > On Mon, Apr 20, 2020 at 4:58 PM Doug Smythies <[hidden email]> wrote:
> > >> On 2019.11.21 07:08 Doug Smythies wrote:
> > >>> On 2019.11.20 23:00 Christian Ehrhardt wrote:
> > >>>> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
> > >>>>> On 2019.11.19 09:32 Joshua Powers wrote:
> > >>
> > >> Currently, "virt-* tools" shows on the table of contents column,
> > >> but clicking the link goes to the source code page and not the
> > >> published page.
> > >
> > > Hi Doug,
> > > I didn't change anything, but for me "virt-tools" on [1] lead to [2]
> > > which is the published page.
> > > I saw you already made the change to the page content that you wanted to make,
> > > but did you (or someone else) already fix this link as well or might this be
> > > depending on who (user/browser/...) looks at it?
> > >
> >
> > I attempted to fix the link last night my time, a few hours before your e-mail
> > time stamp.
> >
> > I also had a conflict edit on that same page with Josh earlier yesterday, but
> > do not yet now how to look up revision histories on discourse so don't
> > know what he was doing.
>
> At the top of the post (if it is a wiki type as our guide posts are)
> there is a little counter which shows the number of versions.
> It is a Number followed by a "pen on a paper" icon.
> That opens up the history and you can switch through versions.
>
> For example I see you adding the self-link to "Introduction" as last edit.
> Josh before did change "virt-* tools" to "virt tools" and so on.
>
> > I could not see my attempt to include that page at the time,
> > it still went to the discourse source page instead, but I
> > do see it this morning.
> > I wonder if a new html page needs time to actually create or something,
> > just like the PDF is only daily.
>
> IIRC html usually rendered sub 30 minutes for me, mostly almost instantly.
> And that seems to be true as your [2] has your last changes.
>
> I haven't checked the PDF in the past so I don't know what to estimate.
>
> But I agree that there the whole section of virt-tools is missing.
> PDF directly goes from uvt to lxd skipping virt-tools.
> Maybe that is why Josh updated the link?
>
> There might be something missing on the virt-tools page.
> Other than the majority of pages around it it was created by me (a
> split from other virt* pages).
> I have added the tags to the page and links from the introduction to
> finally confirm it was rendered into HTML.
>
> But I never checked the PDF, maybe there is some other tweak yet
> unknown to me needed to properly render it into PDF as well.
> I'll ask around and let you know if I find anything.

I found Robin (on CC now) who was able to point me to the PDF conversion job.
It would run once per day, but fails since ~1.5 months.

We talked about fixing that as well as adding a "generated at <date>"
into the PDF to spot such issues more easily.

Robin will look after the job and most likely reply here once things are fixed.

> > > [1]: https://ubuntu.com/server/docs
> > > [2]: https://ubuntu.com/server/docs/virtualization-virt-tools
> >
> >
> >
> >
>
> --
> Christian Ehrhardt
> Staff Engineer, Ubuntu Server
> Canonical Ltd



--
Christian Ehrhardt
Staff Engineer, Ubuntu Server
Canonical Ltd

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
On 2020.04.22 03:50 Christian Ehrhardt wrote:

> On Wed, Apr 22, 2020 at 8:13 AM Christian Ehrhardt wrote:
>> On Tue, Apr 21, 2020 at 4:31 PM Doug Smythies <[hidden email]> wrote:
>>> On 2020.04.21 00:03 Christian Ehrhardt wrote:
>>>>> On Mon, Apr 20, 2020 at 4:58 PM Doug Smythies <[hidden email]> wrote:
>>>>>> On 2019.11.21 07:08 Doug Smythies wrote:
>>>>>>> On 2019.11.20 23:00 Christian Ehrhardt wrote:
>>>>>>>> On Thu, Nov 21, 2019 at 12:11 AM Doug Smythies <[hidden email]> wrote:
>>>>>>>>> On 2019.11.19 09:32 Joshua Powers wrote:
>
>> At the top of the post (if it is a wiki type as our guide posts are)
>> there is a little counter which shows the number of versions.
>> It is a Number followed by a "pen on a paper" icon.
>> That opens up the history and you can switch through versions.
>>
>> For example I see you adding the self-link to "Introduction" as last edit.
>> Josh before did change "virt-* tools" to "virt tools" and so on.

Found it, thanks.

>>> I could not see my attempt to include that page at the time,
>>> it still went to the discourse source page instead, but I
>>> do see it this morning.
>>> I wonder if a new html page needs time to actually create or something,
>>> just like the PDF is only daily.
>>
>> IIRC html usually rendered sub 30 minutes for me, mostly almost instantly.
>> And that seems to be true as your [2] has your last changes.

Thanks for explaining your experience.

I found and fixed two more navigation links that went to the discourse source
page instead of the html last night.

One took awhile to take effect, and one was more or less immediate.

>
> I haven't checked the PDF in the past so I don't know what to estimate.
>

The note on the intro source page [3] says once per day,
I waited about 30 hours, but didn't see it updated.
My purpose here, was less to do with my edit, but to
see if the file name changed, as I have linked to it directly
from the help.ubuntu.com base page [4].

i.e. that particular edit to the intro page was basically a test.

>> But I never checked the PDF, maybe there is some other tweak yet
>> unknown to me needed to properly render it into PDF as well.
>> I'll ask around and let you know if I find anything.
>
> I found Robin (on CC now) who was able to point me to the PDF conversion job.
> It would run once per day, but fails since ~1.5 months.
>
> We talked about fixing that as well as adding a "generated at <date>"
> into the PDF to spot such issues more easily.
>
> Robin will look after the job and most likely reply here once things are fixed.

Thanks.

> > > [1]: https://ubuntu.com/server/docs
> > > [2]: https://ubuntu.com/server/docs/virtualization-virt-tools
[3] https://discourse.ubuntu.com/t/introduction/11322
[4] https://help.ubuntu.com/




--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
Addendum:

On 2020.04.22 07:13 Doug wrote:

>>
>> I haven't checked the PDF in the past so I don't know what to estimate.
>>
>
> The note on the intro source page [3] says once per day,
> I waited about 30 hours, but didn't see it updated.
> My purpose here, was less to do with my edit, but to
> see if the file name changed, as I have linked to it directly
> from the help.ubuntu.com base page [4].
>
> i.e. that particular edit to the intro page was basically a test.

I am so dense sometimes.
I have submitted a change:

- ...target="_top">HTML</a> and <a href="https://assets.ubuntu.com/v1/0032cef9-ubuntu-server-guide.pdf">PDF</a>
+ ...target="_top">HTML</a> and <a href="https://assets.ubuntu.com/ubuntu-server-guide">PDF</a>

Just like in the intro source code page.



--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

20.04 release day publication of help.ubuntu.com

Doug Smythies
The release day publication (the job runs at noon UTC) of help.ubuntu.com will:

. change the "lts" and "stable" links as normal for the desktop help and installation guide, but delete them for the serverguide.
. redirects for the serverguide html and pdf have been added to .htaccess to send users to the new 20.04 locations.
  . note that it is impractical, as things will change, to map embedded links, so they are dropped. i.e., these requests:
    https://help.ubuntu.com/lts/serverguide/remote-administration.html
    https://help.ubuntu.com/stable/serverguide/remote-administration.html
    https://help.ubuntu.com/20.04/serverguide/remote-administration.html
    would become this:
    https://ubuntu.com/server/docs
  . note 2: I do not have a way to test this on my test server, so it might take a day or 5 to get right.
. the base page table entries for the serverguide are present, but will take the user to the new locations.
. the robots.txt file has been modified so that bots will no longer index the serverguide from here (there?).

... Doug

Note: There a troubles compiling the installation-guide, so there is only a place holder for now.



--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: New Ubuntu Server Guide Live

Robin Winslow
In reply to this post by Doug Smythies
Hi all

Yes I'm afraid our script broke because of a change in the Discourse API a
while ago, but now it turns out there were a couple of issues on top of
that too. A couple of months ago IS put a new content-cache in front of our
sites and it further broke the script in two ways.

We will be adding a date to the PDF so you can see when it was generated,
so you could notice that it wasn't updating every day and let us know.

The last blocker should be the resolution of this RT, which will hopefully
happen today: https://portal.admin.canonical.com/C125530/

I'll let you know when the job is working again, at which point the PDF
should hopefully be published daily again.

Cheers,
Robin



On Wed, Apr 22, 2020 at 3:43 PM Doug Smythies <[hidden email]> wrote:

> Addendum:
>
> On 2020.04.22 07:13 Doug wrote:
>
> >>
> >> I haven't checked the PDF in the past so I don't know what to estimate.
> >>
> >
> > The note on the intro source page [3] says once per day,
> > I waited about 30 hours, but didn't see it updated.
> > My purpose here, was less to do with my edit, but to
> > see if the file name changed, as I have linked to it directly
> > from the help.ubuntu.com base page [4].
> >
> > i.e. that particular edit to the intro page was basically a test.
>
> I am so dense sometimes.
> I have submitted a change:
>
> - ...target="_top">HTML</a> and <a href="
> https://assets.ubuntu.com/v1/0032cef9-ubuntu-server-guide.pdf">PDF</a>
> + ...target="_top">HTML</a> and <a href="
> https://assets.ubuntu.com/ubuntu-server-guide">PDF</a>
>
> Just like in the intro source code page.
>
>
>
--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: New Ubuntu Server Guide Live

Robin Winslow
Hi all

Sorry this is quite a delayed update, but the publishing issue for the
server guide was fixed by IS on 29th April, and has been building daily
ever since.

You can always find the latest version of the PDF with the link
https://assets.ubuntu.com/ubuntu-server-guide.

The guide now includes text at the very bottom saying e.g. "PDF generated
on 2020-05-07 03:53:16", so you can see how fresh the content is.

Let me know if you find any more issues with this.

Cheers,
Robin

On Thu, Apr 23, 2020 at 11:46 AM Robin Winslow <[hidden email]> wrote:

> Hi all
>
> Yes I'm afraid our script broke because of a change in the Discourse API a
> while ago, but now it turns out there were a couple of issues on top of
> that too. A couple of months ago IS put a new content-cache in front of our
> sites and it further broke the script in two ways.
>
> We will be adding a date to the PDF so you can see when it was generated,
> so you could notice that it wasn't updating every day and let us know.
>
> The last blocker should be the resolution of this RT, which will hopefully
> happen today: https://portal.admin.canonical.com/C125530/
>
> I'll let you know when the job is working again, at which point the PDF
> should hopefully be published daily again.
>
> Cheers,
> Robin
>
>
>
> On Wed, Apr 22, 2020 at 3:43 PM Doug Smythies <[hidden email]> wrote:
>
>> Addendum:
>>
>> On 2020.04.22 07:13 Doug wrote:
>>
>> >>
>> >> I haven't checked the PDF in the past so I don't know what to estimate.
>> >>
>> >
>> > The note on the intro source page [3] says once per day,
>> > I waited about 30 hours, but didn't see it updated.
>> > My purpose here, was less to do with my edit, but to
>> > see if the file name changed, as I have linked to it directly
>> > from the help.ubuntu.com base page [4].
>> >
>> > i.e. that particular edit to the intro page was basically a test.
>>
>> I am so dense sometimes.
>> I have submitted a change:
>>
>> - ...target="_top">HTML</a> and <a href="
>> https://assets.ubuntu.com/v1/0032cef9-ubuntu-server-guide.pdf">PDF</a>
>> + ...target="_top">HTML</a> and <a href="
>> https://assets.ubuntu.com/ubuntu-server-guide">PDF</a>
>>
>> Just like in the intro source code page.
>>
>>
>>
--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

RE: New Ubuntu Server Guide Live

Doug Smythies
On 2020.05.07 01:58 Robin Winslow wrote:

> Sorry this is quite a delayed update,
> but the publishing issue for the server
> guide was fixed by IS on 29th April,
> and has been building daily ever since.

Yes, I noticed. Thank you.

> You can always find the latest version of the
> PDF with the link https://assets.ubuntu.com/ubuntu-server-guide.
>
> The guide now includes text at the very bottom saying e.g.
> "PDF generated on 2020-05-07 03:53:16", so you can see how
> fresh the content is.

> Let me know if you find any more issues with this.

There was an issue with a big spew of the URL stuff
on the navigation page from the discourse source.
That was late last night (pages 4-6):
https://assets.ubuntu.com/v1/59989c24-ubuntu-server-guide.pdf
But I see the entire navigation page is gone this morning, which
makes sense as the table of contents tab can be used.

... Doug



--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc