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

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



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
#  "The purpose of IT is to seamlessly and transparently provide the other
#  9/10's of the iceberg for people who need to work with chunks
#  of floating ice." -- Strata Rose Chalup
diff --git a/english/doc/books.data b/english/doc/books.data
index cb75940dc1b..fbb058bf81b 100644
--- a/english/doc/books.data
+++ b/english/doc/books.data
@@ -21,15 +21,15 @@
 
 <language name="dutch">
 <bookentry>
-  <title Debian 8, van inleiding tot systeembeheer>
+  <title Debian 9, van inleiding tot systeembeheer>
   <author Koen Wybo>
-  <publisher brave new books>
+  <publisher pumbo>
   <URL "http://linuxleren.nl/";>
   <email koen.wybo@telenet.be>
   <br />
   <description
   <gettext domain="doc">
-  Debian 8 is the must-have handbook for learning Linux. Start on the
+  Debian 9 is the must-have handbook for learning Linux. Start on the
   beginners level and learn how to deploy the system with graphical
   interface and terminal.
   This book provides the basic knowledge to grow and become a 'junior'

Reply to: