Re: RFA: www.debian.org/doc/books

["der.hans" <Verteiler+debian-www@LuftHans.com>]

Am 28. Mar, 2019 schwätzte Laura Arjona Reina so:

moin moin Laura,

> Thanks! I have committed your patch.

Thanks! I see the update in the repo. Just sent a patch to add a tag for
debian release.

ciao,

der.hans

> Kind regards,
>
> El 26/3/19 a las 21:42, der.hans escribió:
> > Am 26. Mar, 2019 schwätzte Laura Arjona Reina so:
> >
> > moin moin Laura,
> >
> > A first small update attached.
> >
> > Koen confirmed that there's a new version and said he's with a new
> > publisher.
> >
> > ciao,
> >
> > der.hans
> >
> > > Hi!
> > >
> > > El 25/3/19 a las 3:02, der.hans escribió:
> > > > Am 22. Mar, 2019 schwätzte Laura Arjona Reina so:
> > > >
> > > > moin moin Laura,
> > > >
> > > > I went through the first half of the list.
> > >
> > > Great, thanks!
> > >
> > > > I have contacted a few of the authors to verify updated information.
> > > >
> > > > Can we somewhat easily add fields? I think it would be nice to add
> > > > debian
> > > > release and ISBN.
> > > It's doable.
> > >
> > > We define the fields in this file:
> > > https://salsa.debian.org/webmaster-team/webwml/blob/master/english/doc/books.def
> > >
> > >
> > > for example, a new tag ISBN would be:
> > >
> > > <define-tag author>
> > >  <strong><gettext domain="doc">ISBN:</gettext></strong> %attributes<br />
> > > </define-tag>
> > >
> > > Then, the tag is used in each entry in the books.data file:
> > >
> > > https://salsa.debian.org/webmaster-team/webwml/blob/master/english/doc/books.data
> > >
> > >
> > > It the above case, it would be:
> > >
> > > <ISBN 999-999-999>
> > >
> > > (no need to add the field to every book entry right now, it's ok if some
> > > of them have it and others not).
> > >
> > > I'm happy to review and accept Salsa merge requests or patches with your
> > > changes to those files to get the fields you need added. If it's too
> > > much and you'd prefer that other person add the fields, just tell and
> > > I'll do it. If you want to do it yourself but need a bit of help, you
> > > can contact me off-list and I'll provide more detailed steps.
> > >
> > > Kind regards,
> > >
> > > > And a random sig about books appears :).
> > > >
> > > > ciao,
> > > >
> > > > der.hans
> > > >
> > > > > Hi!
> > > > >
> > > > > El 22 de marzo de 2019 18:57:39 CET, "der.hans"
> > > > > <Verteiler+debian-www@LuftHans.com> escribió:
> > > > > > Am 21. Mar, 2019 schwätzte Laura Arjona Reina so:
> > > > > >
> > > > > > moin moin Laura,
> > > > > >
> > > > > > I would like to help out with this if I can.
> > > > >
> > > > > Great! Thanks!
> > > > >
> > > > > Do you have to be a debian
> > > > > > developer to help?
> > > > > No, merge requests in Salsa or diffs/patches to the list are perfectly
> > > > > fine. After some successful contributions, you could get permissions
> > > > > to commit directly to the repo.
> > > > >
> > > > >
> > > > > > The initial need is to go through the current list and verify the
> > > > > > listed
> > > > > > books are relevant to stable?
> > > > >
> > > > > Yes, we can start with that.
> > > > > If I receive a new request via books@ I can forward. I'll also have a
> > > > > look at the mailbox archives to see if there is a pending request and
> > > > > file a bug.
> > > > >
> > > > > Thanks!
> > > > >
> > > > >
> > > > > > ciao,
> > > > > >
> > > > > > der.hans
> > > > > >
> > > > > > > Dear all
> > > > > > > As part of the recent web team sprint [1] (report will come in the
> > > > > > > following days hopefully), we have reviewed several areas of the
> > > > > > website
> > > > > > > that were in need of maintenance.
> > > > > > >
> > > > > > > [1] https://wiki.debian.org/Sprints/2019/DebianWebTeam
> > > > > > >
> > > > > > > For the /english/doc/books page [2], we need maintainer(s) to keep
> > > > > > > up-to-date the database of books, process new requests, and care
> > > > > > about
> > > > > > > the bugs related to the list of books, if any.
> > > > > > >
> > > > > > > [2] https://www.debian.org/books
> > > > > > >
> > > > > > > This is a call for help, or request for "adoption": would anybody
> > > > > > > volunteer to this task?
> > > > > > >
> > > > > > > In the /english/doc folder of our repo [3] you can find the
> > > > > > > books-related files.
> > > > > > >
> > > > > > > [3]
> > > > > > https://salsa.debian.org/webmaster-team/webwml/blob/master/english/doc/
> > > > > >
> > > > > > > Maintaining the /doc/books section can be a nice entry point for
> > > > > > > somebody to get involved in the Debian web team. Technically
> > > > > > speaking,
> > > > > > > it's an easy job, but the "curation" task that a human provides is
> > > > > > very
> > > > > > > appreciated by our users. On the contrary, an outdated or
> > > > > > unmaintained
> > > > > > > list of books looses its value very quickly.
> > > > > > >
> > > > > > > If somebody is interested in adoption, they won't be alone (at least
> > > > > > at
> > > > > > > the beginning). I've included my address in the alias
> > > > > > books@debian.org
> > > > > > > to work together with them until they find a suitable workflow and
> > > > > > they
> > > > > > > feel comfortable doing the task themselves. We'll also document
> > > > > > > everything for others to jump in too.
> > > > > > >
> > > > > > > If nobody steps ahead at the end of the year, we'll move the current
> > > > > > > (English) content to a page under wiki.debian.org, removing the
> > > > > > section
> > > > > > > (English and translations) from www.debian.org.
> > > > > > >
> > > > > > > If you are interested, reply to this message in the public mailing
> > > > > > list
> > > > > > > (debian-www@lists.debian.org) or privately to books@debian.org and
> > > > > > I'll
> > > > > > > point to detailed steps to start. You can also join #debian-www IRC
> > > > > > > channel (in irc.debian.org).
> > > > > > >
> > > > > > > Kind regards,

--
#  https://www.LuftHans.com   https://www.PhxLinux.org
#  "Just because it can be exploited doesn't mean it's a weakness" -- der.hans