Problem/Motivation
Proposing adding a "Introduced terminology" section in the default new issue template for Drupal core. The heading is for core contributors to list new words or terms they are adding to Drupal core or identify new ways they are using an existing word in their work.
The Drupalisms working group is cataloging existing words in the Drupal core code base, including words that also appear in the administration user interface, in order to identify Drupalisms which are "Drupal terms that cause confusion". More information about this work is available in De-jargoning Drupal – working with the community to open up Drupal’s terminology.
New code is added to Drupal core regularly. By encouraging core contributors to identify what words or terms they are introducing in the issue summary, it will be more straightforward for the working group to collaborate with core committers to identify words or uses of words that need to be added to the working group's catalog of terminology on an ongoing basis. Surfacing new words may have the added benefit of being more intentional with meaning in the Drupal project as time goes on.
Steps to reproduce
n/a
Proposed resolution
<h3 id="summary-problem-motivation">Problem/Motivation</h3>
<h4 id="summary-steps-reproduce">Steps to reproduce</h4>
<h3 id="summary-proposed-resolution">Proposed resolution</h3>
<h3 id="summary-remaining-tasks">Remaining tasks</h3>
<h3 id="summary-ui-changes">User interface changes</h3>
<h3 id="summary-introduced-terminology">Introduced terminology</h3>
<h3 id="summary-api-changes">API changes</h3>
<h3 id="summary-data-model-changes">Data model changes</h3>
<h3 id="summary-release-notes">Release notes snippet</h3>
Remaining tasks
- Add
<h3 id="summary-introduced-terminology">Introduced terminology</h3> (New naming and terminology, or additional or changed meanings of existing names and terminology.)
to the Issue Summary Template section following
<h3 id="summary-ui-changes">User interface changes</h3>
- Add
<h3>Introduced terminology</h3> <p>A list of new terminology (names for things and concepts), or additions to or changes to meanings of existing names and terminology that will need to be documented on Drupal.org.</p> <h4>Example</h4> <blockquote>Topbar The topbar is the first container element that appears in the viewport when a user is logged in to a Drupal site. It spans the width of the viewport and contains administrative links.</blockquote> <h4>Details to include</h4> <ul> <li>The terminology name or label.</li> <li>A clear and concise description of what the terminology refers to in the code or interface.</li></ul>
to the Issue Summary Template examples section, following https://www.drupal.org/node/3156939/#ui-changes
User interface changes
n/a
API changes
n/a
Data model changes
n/a
Release notes snippet
n/a