Stable and Stark at this point are quite similar. However, Stark is using core templates, which may well change over time, potentially breaking subthemes. Stable has duplicated the core templates which will remain consistent throughout the D8 lifecycle. Unlike in D7, there is never a reason to use Stark as a basetheme. Why is it listed on the Appearance page? And worse, why are users prompted to "Learn how to build a custom theme from Stark..."?

I recommend removing Stark from the /appearance page or at least modifying the help text to express Stable or Classy are better options:

Stark
Intended as a testing platform to view default markup. This should never be subthemed as future core updates may break your theme. Instead, core supplies Classy and Stable which are better options. Numerous contributed base themes exist, as well. Learn how to build a custom themes in the Theming Guide.

Thoughts?

CommentFileSizeAuthor
#66 interdiff_64_66.txt1.09 KBjnlar
#66 2854576-66.patch5.78 KBjnlar
#65 interdiff_64_65.txt912 bytesjnlar
#65 2854576-65.patch5.57 KBjnlar
#64 interdiff_63-64.txt753 bytesTanuj.
#64 2854576-64.patch4.99 KBTanuj.
#63 2854576-63.patch4.99 KBsahil.goyal
#56 interdiff_54-56.txt1.56 KBvsujeetkumar
#56 2854576_56.patch8.93 KBvsujeetkumar
#54 2854576-54.patch9.05 KBnamitasaxena
#53 2464635-53.patch12.52 KBnamitasaxena
#52 2854576-52.patch9.05 KBnamitasaxena
#49 2854576_49.patch9.51 KBvsujeetkumar
#45 stark_help-2854576-45.patch5.21 KBfabienly
#43 stark_help-2854576-43.patch788 bytesfabienly
#40 stark_help-2854576-40.patch776 bytesNonProfit
#35 stark_help-2854576-35.patch761 bytesNonProfit
#34 stark_help-2854576-34.patch778 bytesNonProfit
#33 stark_help-2854576-33.patch775 bytesNonProfit
#30 stark_help-2854576-30.patch1.34 KBNonProfit
#27 stark_help-2854576-27.patch1023 bytesNonProfit
#24 starktext_2854576_24.patch1.02 KBAndrewTur
#21 starktext_8254576_20.patch1.03 KBMeenakshiG
#19 starktext_8254576_19.patch1.02 KBMeenakshiG
#12 stark_2854576_11.patch823 bytesMeenakshiG
#11 stark_2854576_10.patch1.17 KBMeenakshiG
#9 stark_help-2854576-9.patch1.51 KBNonProfit
#7 stark_help-2854576-6.patch1.51 KBNonProfit
#5 stark_help-2854576-5.patch1.51 KBNonProfit
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

NonProfit created an issue. See original summary.

NonProfit’s picture

Component: theme system » Stark theme
mortendk’s picture

yes pleaseremove stark, its only D7 ppl that understands what stark is and as i recall there was pushback on this originally cause ppl were still unsure that there was only classy or stable, and didnt really got the concept that stark is no more.

NonProfit’s picture

Morton, Thanks for your reply. Do you think we should at the same time also display Classy so uninformed folks don't mistakenly believe there is no longer a core basetheme?

NonProfit’s picture

Status: Active » Needs review
FileSize
1.51 KB

This patch exposes Stable and hides Stark from the /appearance page. It also changes the descriptions for both.

Status: Needs review » Needs work

The last submitted patch, 5: stark_help-2854576-5.patch, failed testing.

NonProfit’s picture

Status: Needs work » Needs review
FileSize
1.51 KB

Oops. Patch fixed.

Status: Needs review » Needs work

The last submitted patch, 7: stark_help-2854576-6.patch, failed testing.

NonProfit’s picture

Version: 8.4.x-dev » 8.5.x-dev

Drupal 8.4.0-alpha1 will be released the week of July 31, 2017, which means new developments and disruptive changes should now be targeted against the 8.5.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

MeenakshiG’s picture

This patch removes stark from the appearance page and also modifies the description telling stable or classy as better option

MeenakshiG’s picture

here the patch changes the help text

MeenakshiG’s picture

Status: Needs work » Needs review
MeenakshiG’s picture

The last submitted patch, 9: stark_help-2854576-9.patch, failed testing. View results

MeenakshiG’s picture

Status: Needs review » Reviewed & tested by the community
xjm’s picture

Title: Improve Stark's help text » Discourage use of Stark as a base theme (and possibly mark it internal or hidden)
Status: Reviewed & tested by the community » Needs work
Issue tags: +Needs subsystem maintainer review

Thanks @Meenakshi Gupta.

This text could use some improvements for a few reasons:

  1. It's quite long. We should try to make the text as short as possible while still clearly conveying necessary information.
  2. The phrase "Intended as" is unnecessary. It might be better to start off with something like:

    A testing theme for Drupal's default HTML and CSS.

  3. It's removing useful link references that it has HEAD. The links provide valuable information. It would be better to correct the syntax and retain the helpful link.
  4. The word "never" is quite strong.
  5. It might be better to go the route of actually hiding the theme than to add so many words telling the user not to use it. In order to hide the theme from the UI, we would need to change the assumptions in tests that depend on it, so I can see having that as a separate scope from improving the help text.
  6. However, compare stark.info.yml with bartik.info.yml. In that theme, the fact that it is internal is documented in the code comments, rather than in user-facing text. I did not find an existing issue to do that, so we could do it here.

Also a note on core process: In the future, you should not set your own patch to "Reviewed and Tested By the Community". Drupal core uses a peer review process, so the patch should only be set to RTBC by someone else who has read and thoroughly reviewed your patch. Reference: https://www.drupal.org/patch/review

Tagging for subsystem maintainer review, as the decision as to what exactly to do with Stark should have input from the subsystem maintainer.

xjm’s picture

Oh, you might also find this reference for escaping quotes in YAML helpful: http://yaml.org/spec/current.html#id2534365

MeenakshiG’s picture

Status: Needs work » Needs review
FileSize
1.02 KB

@xjm Thanks for correcting me . I have tried to improve the text as much as possible as suggested by you and also hided the theme from the appearance page .
is it right now ?

Status: Needs review » Needs work

The last submitted patch, 19: starktext_8254576_19.patch, failed testing. View results

MeenakshiG’s picture

Status: Needs work » Needs review
FileSize
1.03 KB

other changes done but unable to hide stark from appearance page

MeenakshiG’s picture

Status: Needs review » Needs work
Sutharsan’s picture

Issue tags: +Novice, +Vienna2017
AndrewTur’s picture

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.6.x-dev » 8.7.x-dev

Drupal 8.6.0-alpha1 will be released the week of July 16, 2018, which means new developments and disruptive changes should now be targeted against the 8.7.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

NonProfit’s picture

Status: Needs work » Needs review
FileSize
1023 bytes

Rerolled for 8.7.x-dev.

Status: Needs review » Needs work

The last submitted patch, 27: stark_help-2854576-27.patch, failed testing. View results

NonProfit’s picture

NonProfit’s picture

Version: 8.7.x-dev » 8.8.x-dev

Drupal 8.7.0-alpha1 will be released the week of March 11, 2019, which means new developments and disruptive changes should now be targeted against the 8.8.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

vacho’s picture

Patch #30 locks good, hide Stable theme and comment the use of Stark theme. However is needed solve test problems.

NonProfit’s picture

vacho, you raise a very valid point that the theme should be displayed on /admin/appearance

How about if the description reads 'An intentionally plain theme for demonstrating and testing Drupal’s default HTML and CSS. Stark.x should not be used as a base theme, instead learn how to build a custom theme in the <a href="https://www.drupal.org/docs/8/theming">Theming Guide</a>.'?

NonProfit’s picture

Noticed a typo above and reworded to 'An intentionally plain theme for demonstrating and testing Drupal’s default HTML and CSS. Stark is not typically used as a base theme, instead learn how to build a custom theme in the <a href="https://www.drupal.org/docs/8/theming">Theming Guide</a>.'

NonProfit’s picture

Status: Needs work » Needs review
borisson_’s picture

Status: Needs review » Needs work

@NonProfit please don't queue all the tests. Running tests on drupal,.org is expensive and a change like this doesn't need to be tested on all supported php/db versions. This is a simple string change and that should not be different over different infra versions.

The hidden:true is removed from the latest patches (in #30 I think), that change should still be in the final patch.

NonProfit’s picture

@borisson_,

Thanks for the clarification. Am I correct in understanding that in a simple change like this, any one of the tests would have been sufficient?

Hidden was not included in the patch as my intent was to continue to expose the Stark to /admin/appearance and allow it to be selected through the UI. With clearer help text, isn't it preferable to allow it to be quickly enabled for testing?

borisson_’s picture

Thanks for the clarification. Am I correct in understanding that in a simple change like this, any one of the tests would have been sufficient?

Yes, you don't need to queue any test yourself. Just setting this issue to needs review will automatically trigger the testbot in the default configuration for the latest uploaded .patch/.diff file.

Hidden was not included in the patch as my intent was to continue to expose the Stark to /admin/appearance and allow it to be selected through the UI. With clearer help text, isn't it preferable to allow it to be quickly enabled for testing?

I'm not sure, in theory the stark maintainer should pick this up but @xjm already marked it as such in august 2017. I think it should be hidden but my opinion is just as strong as yours.

NonProfit’s picture

Status: Needs work » Needs review
FileSize
776 bytes

borisson_,

I'm certainly willing to defer on this, per your recommendation, I've added hidden to the patch.

Thank you

fabienly’s picture

Hi ,
I tried patch 40. I haven't been able to apply the patch.

>git apply stark_help-2854576-40.patch
error: patch failed: core/themes/stark/stark.info.yml:1
error: core/themes/stark/stark.info.yml: patch does not apply

I tried different folder just in case and two drupal installation but it didn't apply.
I tried the code manually, it is working well.
So I am not sure if they are a problem with the patch or if I miss something but the code is fine.

NonProfit’s picture

Hi fabienly,

Thanks for checking this out! Sorry it's not working out.

Here's what I do and the patch applies cleanly for me:

1) Create a new folder and git clone --branch 8.8.x https://git.drupalcode.org/project/drupal.git
2) Change directory to the root cd drupal
2) Add the patch to the root folder
3) Apply the patch git apply -v stark_help-2854576-40.patch

fabienly’s picture

Hi NonProfit,

thanks for your answer.
First I a have a question : Are they difference between banch 8.8.x from drupal core clone from git and the zip named Drupal core 8.8.x-dev found on this page ?

I tried your process and your patch applied successfully as you said.

1- But the hidden parameter don't appear in stark.info.yml file after application.
I found that they are a space in front of the + so I change that in the new patch.

2- This is the process that I use to test patch :

  • 1) Create a new folder and git clone --branch 8.8.x https://git.drupalcode.org/project/drupal.git
  • 2) Change directory to the root cd drupal
  • 3) Install vendor and add drush via composer : composer require drush/drush
  • 4) Install drupal via drush : vendor/bin/drush si --db-url="mysql://root:@localhost:3306/drupalcontrib" -y
  • 3) Add the patch to the root folder
  • 3) Apply the patch git apply -v stark_help-2854576-40.patch

With this process I am ready to test the patch before and after and check the code and the UI.
when I did that your patch didn't applied and I don't really understand why.

So I make a new patch based on your code who was great and I test to apply it with your process and mine. In both case it works.

Status: Needs review » Needs work

The last submitted patch, 43: stark_help-2854576-43.patch, failed testing. View results

fabienly’s picture

Status: Needs work » Needs review
FileSize
5.21 KB

After investigation, I discovered my patch failed due to automated tests who try to install stark theme. But when the patch applied the hidden property all tests linked to stark theme installation failed. So I remove all stark installation in tests.

Locally all the tests pass, lets see if it is the same with the drupal.org bot.

Status: Needs review » Needs work

The last submitted patch, 45: stark_help-2854576-45.patch, failed testing. View results

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.0-alpha1 will be released the week of October 14th, 2019, which means new developments and disruptive changes should now be targeted against the 8.9.x-dev branch. (Any changes to 8.9.x will also be committed to 9.0.x in preparation for Drupal 9’s release, but some changes like significant feature additions will be deferred to 9.1.x.). For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.9.x-dev » 9.1.x-dev

Drupal 8.9.0-beta1 was released on March 20, 2020. 8.9.x is the final, long-term support (LTS) minor release of Drupal 8, which means new developments and disruptive changes should now be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

vsujeetkumar’s picture

Re-roll in 9.1 and fixed tests, Please review.

Status: Needs review » Needs work

The last submitted patch, 49: 2854576_49.patch, failed testing. View results

Version: 9.1.x-dev » 9.2.x-dev

Drupal 9.1.0-alpha1 will be released the week of October 19, 2020, which means new developments and disruptive changes should now be targeted for the 9.2.x-dev branch. For more information see the Drupal 9 minor version schedule and the Allowed changes during the Drupal 9 release cycle.

namitasaxena’s picture

FileSize
9.05 KB

patch re-roll in 9.2.

namitasaxena’s picture

Status: Needs work » Needs review
FileSize
12.52 KB

patch re-roll in 9.2,

namitasaxena’s picture

Patch re-roll for 9.2.
Kindly ignore #53.
I just realised that I had the wrong patch uploaded in #53, apologies for the noise.

Status: Needs review » Needs work

The last submitted patch, 54: 2854576-54.patch, failed testing. View results

vsujeetkumar’s picture

Status: Needs work » Needs review
FileSize
8.93 KB
1.56 KB

Fixing tests.

Status: Needs review » Needs work

The last submitted patch, 56: 2854576_56.patch, failed testing. View results

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

markconroy’s picture

This is going to need a re-roll to remove mention of seven and bartik, etc. Looks pretty simple for a novice task. And then would be great to have it merged.

sahil.goyal’s picture

Reroll the patch for the D10, as seven and bartik are no longer be there at D10 so i would not be there and make the Claro as default, Updating the patch.

Tanuj.’s picture

Fixed CCF on #63.

jnlar’s picture

Unsure what that second failing test is caused by, hopefully fixing the first one resolves it.

jnlar’s picture

Oops, missed updating comment.

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.