In each topic in the User Guide, there is a section near the top that looks something like this (and there is also a similar section for each chapter in the guide.txt file):

[role="summary"]
How to change user account registration settings.

When we import the User Guide into drupal.org, these summary sections become the section/chapter summaries that you see in the boxes on pages like this:
https://www.drupal.org/docs/user_guide/en/understanding-chapter.html

Currently, the field on drupal.org that holds the summaries on the Documentation content types is limited to 140 characters. So, the summaries in our User Guide sections/chapters are (by policy) also limited to 140 characters.

The reason for this particular issue is that when the User Guide was imported into drupal.org today, several of the chapters/sections in the new Spanish translations exceeded 140 characters. Here are some of the error messages from the imports:

09:02:48 Field validation errors in item 'Capítulo 2. Planificación de un     [warning]
09:02:48 sitio web':Summary: the text may not be longer than 140 characters.
09:02:48 
09:02:48 Field validation errors in item 'Capítulo 4. Configuración básica   [warning]
09:02:48 del sitio':Summary: the text may not be longer than 140 characters.
09:02:48 
09:02:48 Field validation errors in item 'Capítulo 6. Configuración de la     [warning]
09:02:48 estructura de contenido':Summary: the text may not be longer than 140
09:02:48 characters.

It looks like these are from the chapter summaries in the guide.txt file, but you might look at the recently-translated topics too. Thanks!

Comments

jhodgdon created an issue. See original summary.

guiu.rocafort.ferrer’s picture

I did a commit fixing the summaries in guide.txt, seems like those where the only ones that where affected, but i will check again tomorrow to make sure i got all of them covered.

By the way @jhodgdon, how did you get those warnings ? Id you maybe get those warnings running the tests in the User Guide Tests ?
( https://www.drupal.org/project/user_guide_tests )

guiu.rocafort.ferrer’s picture

Status: Active » Needs review
jhodgdon’s picture

The warnings are unfortunately only generated when we import the User Guide into drupal.org. @drumm sees them in the Jenkins job logs. Although we could probably add a line to one of the scripts (such as the mkfeeds script) that when it picks out the "summary" part, it would check the length and warn if it is more than 140 characters.

The tests in the User Guide Tests project do not directly look at any of the User Guide source files. The steps and UI text have been coded into the test PHP files.

jhodgdon’s picture

Status: Needs review » Fixed

Anyway, the patch looks good. Let's go ahead and mark it as Fixed.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.