Problem/Motivation

The Issue template links to Drupal 7 docs:

Please read this before creating an issue

When reporting bugs (especially fatal errors or other major flaws), please always make sure that they also occur with the latest versions of all related modules (especially Search API and Entity API (for D7), but – depending on where the bug occurs – maybe also Views, Facet API/Facets, …) and Drupal core.

Please also make sure to search for existing issues (maybe already closed) that discuss your problem, and browse the Common pitfalls and Frequently asked questions sections of the Search API handbook.

Finally, I’m afraid it sometimes happens that I overlook a new issue. If I haven’t replied to your issue at all within a month (usually it should be less than a week), please feel free to ping me via contact form or chat. (Otherwise, please don’t do that!)

Steps to reproduce

Create a new issue, and see links to Drupal 7 docs.

Proposed resolution

Update the links to point to doc pages for modern Drupal.

Remaining tasks

  1. Update the text ("... Entity API (for D7)")
  2. Update the issue template links to modern Drupal, for example https://www.drupal.org/docs/8/modules/search-api/getting-started/common-...
  3. Perhaps request moving Drupal 7 docs to https://www.drupal.org/docs/extending-drupal/contributed-modules/contrib...?

Comments

ressa created an issue. See original summary.

ressa’s picture

ressa
he/him
commented
Title: Update drupal.org issue template links » Update issue template links and text

Remove drupal.org from title.

drunken monkey’s picture

drunken monkey
he/him
Primary language German
Location Vienna, Austria
commented
Status: Active » Fixed

Thanks a lot for the suggestions, makes sense!
Should now all be fixed except for the last item, not sure about that one. I just unlinked the D7 docs from the Search API project page now, that’s probably a good first step. I don’t really know what the proper process is for those older versions of the documentation. Seems d.o should archive those at some point on their own accord.

Now that this issue is closed, please review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, please credit people who helped resolve this issue.

drunken monkey’s picture

drunken monkey
he/him
Primary language German
Location Vienna, Austria
commented
Issue tags: +Vienna2025
ressa’s picture

ressa
he/him
commented

It looks perfect now, thanks! And thank you for maintaining all the Search API modules :)

About the Drupal 7 docs, it's not clear to me why there are these two sections ... I would think the modules under drupal.org/docs/7/modules should be moved to the contributed-module-documentation-archive as well:

drunken monkey’s picture

drunken monkey
he/him
Primary language German
Location Vienna, Austria
commented

From the description of the latter:

Documentation for unsupported modules and modules only compatible with Drupal 6 or earlier should be deleted.

To me, that seems like modules that are still supported should not be moved there, even their Drupal 7 versions. (Especially, our Drupal 7 branch is not wholly unmaintained, we would still address any security issues or critical bugs.)

ressa’s picture

ressa
he/him
commented
Related issues: +#3553118: False warning about Views Bulk Operations (VBO) security update

Yes, though see for example Commerce or Flexslider's Drupal 7 docs, which have been moved to the archive:

https://www.drupal.org/docs/extending-drupal/contributed-modules/contrib...
https://www.drupal.org/docs/extending-drupal/contributed-modules/contrib...

It would be great if it was stated clearly, like "Documentation for Drupal 7 will all be moved here, eventually." or whatever was decided, to make it plain.

And speaking of ambiguity, for example the meaning of the word "Supported", see also #3553118: False warning about Views Bulk Operations (VBO) security update :)

drunken monkey’s picture

drunken monkey
he/him
Primary language German
Location Vienna, Austria
commented

Yes, some clear instructions both for users and contrib maintainers would really be great.

Status: Fixed » Closed (fixed)

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