- Issue created by @ressa
- First commit to issue fork.
- 🇳🇴Norway gisle Norway
I've made a few suggestions on that documentation page's Discussion page. TL;DR: That documentation page is just terrible. It neeed to be scrapped and rewritten from scratch. Just to mention a few problems:
- It conflates updating/deployment with carrying out development task (bad computer science).
- It gives the reader the idea that updating Drupal "manually" is feasible (with Drupal 10, it is not).
- Its target audience is Drupal developers. We need to provide documentation for site owners that are not developers (those are the ones who are currently struggling with updates).
- 🇩🇰Denmark ressa Copenhagen
Yes, even if you're not a developer, but more of a site builder, it's best practice to use Composer, Drush, and Git, and we should document the very basic steps for site owners on how to deploy code changes to production.
I am removing the ", with correct parameters, such as
--no-dev" part to focus on getting the basic steps and commands documented.
- 🇩🇰Denmark ressa Copenhagen
Maybe it's easiest to try to reach a great text here, and when it's ready, add it to the documentation page?
- Status changed to Needs review
over 1 year ago 6:43pm 16 November 2023 - 🇩🇰Denmark ressa Copenhagen
Thanks @gisle, many great points. I went ahead and rewrote the page, to be about updating Drupal, and not development, removed any references to manual update, and simplified the steps, to accommodate site owners, i.e. non-developers.
After that, I added a separate section for the basic steps for deployment of a new feature. It could get its own page, or stay here?
- 🇺🇸United States smustgrave
Feel free to move back but seems this is related to drupal.org pages so seems this project may be more the right spot.
- 🇩🇰Denmark ressa Copenhagen
Yes, thanks @smustgrave, this is the right place for this issue.
- Status changed to RTBC
3 days ago 11:43am 2 April 2025 - 🇳🇿New Zealand quietone
I read the new page and the changes read well to me and are correct. There is a question asked in #6 but, even with that, I think the intent of the issue summary has been fulfilled.
- 🇩🇰Denmark ressa Copenhagen
Thanks for reviewing the page @quietone, it's great to hear that the page works as intended, and may help users looking for help with deploying an update.