search

WordPress / Documentation-Issue-Tracker

Issue Tracker for the WordPress Documentation team.
https://make.wordpress.org/docs/
Other
81 stars 42 forks source link

Outdated content and links to Codex in CSS #424

Closed estelaris closed 1 year ago

estelaris commented 2 years ago

Issue Description

The content needs to be reviewed and almost every link inside the articles links to a Codex article

URL of the Page with the Issue

https://wordpress.org/support/article/css/

Section of Page with the issue

Full article

Why is this a problem?

Outdated documentation

Suggested Fix

github-actions[bot] commented 2 years ago

Heads up @lucprincen @javiercasares - the "advanced administration" label was applied to this issue.

javiercasares commented 2 years ago

Started at https://github.com/zzap/WordPress-Advanced-administration-handbook/pull/3

carolinan commented 1 year ago

I will work on this today.

zzap commented 1 year ago

This one will be moved to Advanced administration handbook.

javiercasares commented 1 year ago

Related:

mrfoxtalbot commented 1 year ago

While working on https://github.com/WordPress/Documentation-Issue-Tracker/issues/313 @kathrynwp noticed that the "Learn more about CSS" link in the Global Styles tab links to this article. Screen Shot on 2023-04-01 at 10:09:53

The new Per Block CSS feature can be very difficult to figure out without some guidance. When we update the main CSS article, let's make sure we include a link to the Styles Overview article.

kathrynwp commented 1 year ago

Since the inline link in all the new CSS editors (both site-wide and per-block) goes to this outdated page – as Alvaro pointed out above – I went ahead and added a prominent note at the top of the page, linking to the new "Applying Custom CSS" section of the "Styles Overview" page. This ensures that people wanting to know more about how to use the new Additional CSS editors that came in with 6.2 will be able to quickly find the relevant information in HelpHub if they click on the inline link.

CSS_–_WordPress_org_Documentation

Of course, please feel free to tweak the wording if it can be improved!

I tried to use the [tip] shortcode as described here, but was not able to get it to work, so if anyone's able to have a look at that, it would be appreciated! I tried using both the Shortcode block and Paragraph block; neither converted the shortcode properly.

javiercasares commented 1 year ago

Applied into the new CSS page. https://github.com/WordPress/Advanced-administration-handbook/issues/196

kathrynwp commented 1 year ago

Hey there – someone keeps setting this page to Private, meaning that it gives a 404 Not Found error.

Since this page is linked to from the dozens of new CSS editors throughout the Site Editor, I think it's quite important that this page either remain available where it is, or have a working redirect in place.

I've once again re-set the page to Public. Could we please leave it that way until there is a working redirect so that millions of WP users don't keep encountering 404s within the Site Editor UI? Thanks. :)

kathrynwp commented 1 year ago

@javiercasares Hi there - regarding my above comment, I was just wondering if the new CSS page has been published yet or not. If it has, would you be able to share the URL, as I'd love to have a peek. (I'm still not seeing any redirect from https://wordpress.org/documentation/article/css/ to the new page.) Thank you very much!