[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Offer to help updating the manual



Hello list and Luca,

On 08/04/2019 12:50, Luca Boccassi wrote:
> On Sun, 2019-04-07 at 13:50 +0200, Roland Clobus wrote:
>> On 06/04/2019 20:22, Luca Boccassi wrote:
>> Encountered issues/Need for information:
>>
>> During the updating of the links I've seen the following, for which I
>> need input from the team members who might know what happened/needs
>> to
>> be done:
>>
>> * The search functionality on
>> https://live-team.pages.debian.net/live-manual/
>>
>> In commit 939ed4a829aa009294689a2ad311f3d9f9880e5f the search form
>> was
>> disabled. Can I remove references to the search functionality?
> 
> I'm not sure what would it take to fix the search for the new live
> pages, if it cannot or nobody volunteers to do so then I think it makes
> sense to remove references to it

I'll delete it (commit 61367bf3bbd68607cedde711f1e87a490748f085 in my
clone of the repo)
When I'm done with updating the URLs, I could take a look whether
pages.debian.net supports the database and cgi.

>> * The page with legal information on
>> http://debian-live.alioth.debian.org/project/legal/
>>  is gone now.
>> Is there a replacement page with similar information?
> 
> I'm not sure what was on that page

The reference is deleted in commit
0b3e1848c74e985d45471326dda2ce883eb56dc0 in my clone of the repo.

Could the content have been this?
https://github.com/debian-live/live.debian.net/blob/master/project/legal.mdwn

>> * Homepage for Live Systems Project (in the upper left corner of the
>> documentation)
>> Do you prefer a link to the team page in salsa [A], or to the Debian
>> Wiki [B]/[C]/[D]? Looking at the pages, I would prefer [D].
>>
>> [A] 
>> https://salsa.debian.org/live-team
>>
>> [B] 
>> https://www.debian.org/devel/debian-live/
>>
>> [C] 
>> https://wiki.debian.org/DebianLive
>>
>> [D] 
>> https://www.debian.org/CD/live
> 
> live-manual applies to live-build, and debian live cds are not build
> with live-build, so I'd say either A or C

I thought that the Debian Live CDs _are_ built with live-build, because
all these pages are interconnected.

I'll go with [C] for the homepage.

>> * The manual refers to the live-build-cgi server (See also #807957)
>> The repository that is mentioned in the ticket is also not reachable
>> any
>> more. Should I remove references to that service for now?
> 
> I think so, same as above.

The reference to the live-build-cgi server is deleted in commit
a9afb3e06906dd6a5607b0df3e24c0c76fa875ac in my clone of the repo.

I think I found (a copy of) the original repository at
https://github.com/debian-live/live-build-cgi

>> * I'll first adapt the English translation. I have noticed that
>> several
>> translations contain links to even older locations of the project.
>> What
>> is your workflow? Should I contacts all translators for permission to
>> update the URLs? (I'm asking, because I've recently seen a discussion
>> on
>> the gnome-i18n mailing list regarding developers changing
>> translations)
> 
> Not sure, sorry

OK, I'll contact all translators soon and ask them about their preferred
workflow.

New questions/need for information while I was going through the manual:

* Regarding functionality: When I run 'lb config' twice, I get a
different content than when I run the command once, e.g. the timestamp
is resolved. Is that intentional?

* 4.5.4 Removed functionality: the standard image. The configuration is
still present in live-config, but the iso images are not present on
http://cdimage.debian.org/cdimage/release/current-live/amd64/iso-hybrid/

* 6.1.2: The auto folder is already present when I run 'lb config'. Can
the 'mkdir auto' step be removed?

* 6.2: Is the abbreviation 'lso' related to live-systems.org, and should
it now be replaced with a more recent abbreviation like 'live' or 'salsa'?

* 8.1.5: There are references to .deb snapshots for
live-config/live-build/live-images (sid-snapshots). Do you know if (and
where) they are generated at the moment?

* 14: Has the status page been migrated to salsa? Or is it part of
[C]/[D]? Or should the link refer to bugs.debian.org instead?
I think a snapshot of the original content is here:
https://github.com/debian-live/live.debian.net/blob/master/project/status.mdwn,
but the question is, whether the project would like to have such a
historical overview as a status page.

* 16.2.2 To which mailing list should these mails be sent to? I haven't
seen a mail in the archives of debian-announce, debian-lts-announce or
debian-live.

Thanks in advance for your answers.
When these questions are answered, I'll be able to prepare a merge
request for the English version of the manual with all changes.

Additionally, an updated for the man pages (live-build) might be
required as well...

With kind regards,
Roland Clobus

Attachment: signature.asc
Description: OpenPGP digital signature


Reply to: