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

[HelpHub] Content review: Weblog client #470

Open
Tracked by #834
estelaris opened this issue Sep 26, 2022 · 7 comments
Open
Tracked by #834

[HelpHub] Content review: Weblog client #470

estelaris opened this issue Sep 26, 2022 · 7 comments
Labels
Content Review external links Discussing content and links for external resource. re-categorization project Part of the re-categorizaton project [Status] Review Issue in review user documentation (HelpHub) Improvements or additions to end-user documentation

Comments

@estelaris
Copy link
Member

Issue Description

Is this article still relevant? The external links haven't been updated since 2012-2016, others are non-existent

URL of the Page with the Issue

Weblog client

Section of Page with the issue

List of client software

Why is this a problem?

Questioning the relevance and accuracy of the information for the latest WP version

Suggested Fix

Review content for accuracy and relevance, if not needed, delete.

@estelaris estelaris added user documentation (HelpHub) Improvements or additions to end-user documentation external links Discussing content and links for external resource. re-categorization project Part of the re-categorizaton project Content Review labels Sep 26, 2022
@github-actions
Copy link

Heads up @femkreations @atachibana - the "user documentation" label was applied to this issue.

@github-actions
Copy link

Heads up @zzap - the "external links" label was applied to this issue.

@pekkakortelainen
Copy link

Notes after review:

  • XML-RPC itself can be easily considered as an outdated method of communicating with WP. It is there mainly for backward compatibility and nothing else nowadays.
  • XML-RPC has its security issues and thus shouldn't be used anywhere.
  • Most clients suggested by the client software list are very outdated.

Conclusion: as REST API is the modern way to go and XML-RPC should be forgotten, IMO this article should be deleted completely.

@jennimckinnon
Copy link
Collaborator

Awesome @pekkakortelainen! I agree. As we discussed on Zoom during Contributor Day today, I also think the explanation could use a little improvement as well; maybe a screenshot and/or analogy or something.

I'll assign you to this so you can edit it. Thank you! 🎉

@estelaris
Copy link
Member Author

I have requested a redirect to the REST API article in DevHub. Once that is created, we can delete the HH article and close this issue

@github-actions
Copy link

Heads up @docs-reviewers - the "[Status] Review" label was applied to this issue.

@coffee2code
Copy link

If the proposed redirect happens, should the REST API article (the redirect target for the Weblog Clients article) also get updated to at least make a mention of XML-RPC (that it existed, technically still works, but is outdated, etc)? (Assuming another XML-RPC specific doc page doesn't exist somewhere.)

It seems the REST API article is more of a replacement for the "Develop Your Own" section of the "Weblog Clients" page, but it does not address the main purpose of the page: listing client apps you can use to connect to a WP site. While I'm sure most of those apps are outdated, aren't at least a few still viable such as WordPress.com Desktop App and maybe MarsEdit (last blog entry 4 days ago)? TypeMetal had a release 10 months ago. I didn't check anything else other than ecto, which does seem defunct.

I can totally understand not wanting to maintain an article on weblog clients since it can quickly become out-of-date or omit newcomers unless regularly maintained. However, I feel that decision should be separate from whether documentation for XML-RPC and/or building your own weblog client should link to or redirect to the REST API article.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content Review external links Discussing content and links for external resource. re-categorization project Part of the re-categorizaton project [Status] Review Issue in review user documentation (HelpHub) Improvements or additions to end-user documentation
Projects
None yet
Development

No branches or pull requests

6 participants