Decide what to do with TO BE MIGRATED

Deleted "Using Drupal 7 with Rackspace CloudFiles CDN" and "Optimizing Drupal on Rackspace Cloud Sites".

I think we might need a meta issue to discuss how to treat D7 specific documentation. That there is a doc page for D8+ doesn't mean that we should delete the D7 version - if we want to support D7.

Deleted "Complete Open Source Dev Stack".

Rant: I really dislike these "mega" guides that covers everything. We recently got a new one for Windows / WSL: Installing Drupal with DDEV in WSL2 on Windows →

Yes, it would help to know if there is a plan or expectation about the Drupal 7 docs.

I'd like to learn more about your preferences for organizing the material on d.o. So far, I like the Diátaxis approach to documentation. It is easy to understand and it promotes incremental fixes as opposed to having a grand design first.

Thanks for organizing the pages to be migrated here @quietone. The "create a static archive" method works well, I updated the commands 12 months ago. So I have created a page in the new documentation system under https://www.drupal.org/docs/administering-a-drupal-site/creating-a-stati... → .

I agree that the monolithic guides are best avoided, since they easily become silos, with a lot of overlap. So the proposal to using a documentation framework such as Diátaxis is a great idea, since we can use that as a guiding philosophy, to make decisions about which structure and style to use.

@drumm has previously added redirects from deleted doc pages to the replacement page in the new doc system, perhaps that's possible? I have added checkboxes the two places where it's currently relevant here, but maybe more redirects can be added?

Adding Delete + Redirect for a few more pages.

@ressa, why did you create a new page for the 'creating a static site' instead of migrating the existing one? I would assume that the migrate process itself would take of making the redirects.

I have added the redirect for that page and updated the IS. So, https://www.drupal.org/node/27882 → can be deleted.

It is hard for me to see the check in the checkbox. Can something else be used?

I didn't use the Migrate documentation feature, because I didn't know it existed. But I tried following the "migrate this documentation" link, and I wouldn't have been able to place it there anyway, since:

You can only migrate pages into the guide you maintain. To create a guide for your project, edit the project page and follow the links on the "Project documentation" tab.

These are the guides I maintain, I supposes because I created them: Boost, Bootstrap5, Chaos Tool Suite (ctools), Geofield, Leaflet, Matomo Analytics, Open ReadSpeaker, and since I don't maintain "Administering a Drupal site" it's not an option.

The checkboxes are simply emojis, so they can be copied from elsewhere on the page, and replaced as needed. Would you prefer using something like this?

Redirect

I found this section about "Migrating legacy documentation", but it seems like a lot of steps, also resulting in an overly convoluted structure, if you just want to add a page under an existing guide ...

https://www.drupal.org/drupalorg/docs/content/documentation#s-migrating-... →

Would it be possible to allow non-maintainers to migrate a page from the old system into an existing guide, so that under "Documentation guide to migrate page(s) into: *" all guides would be listed? Or maybe the "Migrate X child pages" is the reason for the limitation, to keep things under control, and not getting an existing guide flooded with pages?

• I deleted 27882.
• I can migrate directly into any module documentation guide, but not the general docs. It would help if drumm relaxed the conditions now to get the pages faster migrated.

Thanks @hansfn, but it looks like the redirect for /node/27882 got flushed out as well ...

I created 📌 Relax permissions for faster migration of old documentation pages Active .

it looks like the redirect for /node/27882 got flushed out as well

Not under my control. You can readd the redirect under the settings for the page you created.

I can't add a redirect.

Strike through items that are complete.

Thanks @quietone, perhaps redirects to the new pages can be added?

Made some redirects and updated issue summary

Add 2 pages not in the list

Coming here from 📌 Update documentation link on project page Active .

About page 8. ( https://www.drupal.org/node/1919154 → ) I cannot determine but I think the best approach would be to be migrated at https://www.drupal.org/docs/7/modules/organic-groups → , under "Obsolete" ( https://www.drupal.org/docs/7/modules/organic-groups/obsolete → )