Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Outdated content and links to Codex in CSS #424

Closed
3 tasks
Tracked by #834
estelaris opened this issue Aug 25, 2022 · 10 comments
Closed
3 tasks
Tracked by #834

Outdated content and links to Codex in CSS #424

estelaris opened this issue Aug 25, 2022 · 10 comments
Assignees
Labels
advanced administration Issues for Advanced administration Handbook Content Review developer documentation (DevHub) Improvements or additions to developer documentation

Comments

@estelaris
Copy link
Member

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

  • Review and update content to today's CSS standards
  • Remove links to Codex
  • Remove link to WordPress Lessons as article is marked for deletion
@estelaris estelaris added tracking issue Use to track a series of related issues. developer documentation (DevHub) Improvements or additions to developer documentation Content Review advanced administration Issues for Advanced administration Handbook and removed tracking issue Use to track a series of related issues. labels Aug 25, 2022
@github-actions
Copy link

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

@estelaris estelaris changed the title Outdate content and links to Codex in CSS Outdated content and links to Codex in CSS Aug 26, 2022
@javiercasares
Copy link
Collaborator

@carolinan

This comment was marked as outdated.

@zzap
Copy link
Member

zzap commented Oct 25, 2022

This one will be moved to Advanced administration handbook.

@zzap zzap closed this as completed Oct 25, 2022
@javiercasares
Copy link
Collaborator

Related:

@mrfoxtalbot
Copy link

While working on #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
Copy link

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
Copy link
Collaborator

Applied into the new CSS page.
WordPress/Advanced-administration-handbook#196

@kathrynwp
Copy link

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
Copy link

@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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
advanced administration Issues for Advanced administration Handbook Content Review developer documentation (DevHub) Improvements or additions to developer documentation
Projects
Status: Done
Development

No branches or pull requests

6 participants