Re: RFA: www.debian.org/doc/books
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,
>>>>
>>
>>
>
--
Laura Arjona Reina
https://wiki.debian.org/LauraArjona
Reply to: