Recommendations for 'Tutorials and site recipes'

Created on 21 April 2024, 9 months ago

Documentation location/URL

  1. Book: Drupal 7 – the Essentials β†’
    Delete. Now available at https://archive.org/details/Drupal7TheEssentials. Or is this of significance to the community that d.o should have an archive of it?
  2. Drupal 7 - How to use Drupal's i18n and Organic Groups modules to create an international website β†’
    Delete. SEems more about planning and building a site. Also, there is Multilingual guide β†’ , Chapter 10. Making Your Site Multilingual β†’ and Multilingual guide β†’
  3. Site building: beginner, intermediate, advanced β†’
    Having docs of these roles might be useful and I didn't find anything discussing this elsewhere. I don't know where to put it and it would needed updating.

Problem/Motivation

Proposed resolution

Remaining tasks

  1. Videos and slides β†’
    TBD
  2. Tutorials β†’
    TBD
πŸ“Œ Task
Status

Active

Component

Placement/Navigation/Structure

Created by

πŸ‡³πŸ‡ΏNew Zealand quietone

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @quietone
  • πŸ‡³πŸ‡ΏNew Zealand quietone

    Although there is still some TBD there are also items that could be reviewed.

  • Status changed to Needs review 9 months ago
  • πŸ‡³πŸ‡ΏNew Zealand quietone
  • πŸ‡³πŸ‡΄Norway hansfn

    I think we should preserve "Book: Drupal 7 – the Essentials" as the version on drupal.org is the source, it seems - read Book "Drupal 7 – the Essentials" being added to the community wiki.

    "Drupal 7 - How to use Drupal's i18n and Organic Groups modules to create an international website" is about site-building, true, but the content isn't covered in the current "Multilingual guide". If we delete this, it's because it's D7 and D7 is soon EOL. Which is completely fine with me, but then we can delete a lot of already migrated pages too - for example Cookbook: Build a non-English D7 website β†’ in the "Multilingual guide".

    "Site building: beginner, intermediate, advanced" can be deleted IMO. It's better to recreate if someone finds it useful. We are very short on resource so updating it is really not an option.

  • πŸ‡³πŸ‡ΏNew Zealand quietone

    Thanks, with your feedback I have changed my view. I have updated the IS to show where there is agreement.

    I think deleting already migrated Drupal 7 documentation, while related, is out of scope here.

  • πŸ‡³πŸ‡΄Norway hansfn

    I have reviewed / skimmed Videos and slides β†’ and it's filled with dead links. In addition, if a video is a good resource for say a module, it's much better if it is listed directly in that documentation. Strong delete from me..

    I have reviewed and cleaned up Tutorials β†’ . Even if some of the content is still relevant - and even for (early) D8 - I think it's just too random. We should focus on creating new tutorials for D10 in stead. Strong delete from me..

  • πŸ‡³πŸ‡ΏNew Zealand quietone

    I went through more of the Video section and yes way too many dead links.

    In the tutorials there were 2 that caught my attention. 1) "How to programmatically add a product variation to the cart in Drupal commerce 2.x (Drupal 8)". That was last edited in 2019, so fairly recent. But there really isn't a place for it on d.o because Commerce doesn't keep their documentation here, it is at https://docs.drupalcommerce.org. So people should be contributing there. And 2) "How To Manage Breadcrumbs In Your Drupal 8 Module". This has received regular edits up to 2023 although minor. But the bottom of the page there are links to the blogs posts the information came from. So, nothing to save there either.

    I do think that #6 is correct, that it is safe to delete these sections. I've updated the IS accordingly.

  • πŸ‡ΊπŸ‡ΈUnited States eojthebrave Minneapolis, MN

    "Book: Drupal 7 – the Essentials". I'm not opposed to migrating this but wanted to point out that a lot of this content is duplicated elsewhere in the existing Drupal 7 wiki. My hang up is that this becomes something we move now but that it just continues to remain as archival content (which maybe is fine?).

    And while it's maybe historically interesting I think people coming into Drupal at this level today are better served by the User Guide and other more up-to-date resources.

  • πŸ‡³πŸ‡΄Norway hansfn

    I think "Drupal 7: The Essentials" goes deeper than the user guide in some topics - part B and C which covers Views and Rules (and more). I just loved the work that Johan Falk did which makes it hard for me to just "throw" this out. However, you are right, it will never be maintained. Then again there is probably plenty of low quality D7 docs that are already migrated. I end up wanting to migrate this even if it just an archive.

  • Assigned to drumm
  • Status changed to RTBC 3 months ago
  • πŸ‡ΊπŸ‡ΈUnited States drumm NY, US

    I’ll go ahead with the deletions.

    Need to decide where exactly to migrate https://www.drupal.org/documentation/the-essentials-7 β†’

  • πŸ‡ΊπŸ‡ΈUnited States drumm NY, US

    The preserved section of this book tree is now at https://www.drupal.org/docs/7/howtos/book-drupal-7-the-essentials β†’ and the rest is deleted.

  • πŸ‡ΊπŸ‡ΈUnited States drumm NY, US

    Updating credit

  • πŸ‡³πŸ‡΄Norway hansfn

    Thx. The placement of "Book: Drupal 7 – the Essentials" was perfect.

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

Production build 0.71.5 2024