Liferay-learn GitHub repo no longer exists?

Development Tooling
1

Hey everyone,

I was setting up the AI Workspace and noticed that the liferay-learn repo (https://github.com/liferay/liferay-learn) seems to be gone — it’s returning a 404. The CLAUDE.md in the workspace references it as the main source for documentation paths (client extensions, objects, fragments, etc.), so a bunch of those references are now pointing to nothing.

Does anyone know if this repo was moved or merged somewhere else? Would be great to know the new location so we can update the workspace config.

Thanks!

2

Thanks for reaching out! The liferay-learn repository is a private GitHub repository, so I believe it’s expected that it wouldn’t currently be accessible directly.

I checked internally and a member from the dev tools team noted that they’re currently working on updating the workspace files to point to the site instead of the repository, so that change should be available soon.

In the meantime, my understanding is that the recommendation would be to manually update the markdown files to point to learn.liferay.com instead of the repository.

3

Hi @WilsonIsaac ,

I also recently stumbled upon this issue. Currently, the agent still has no access to the documentation, and I’m not sure how we could direct it to http://learn.liferay.com/ as it’s not easily searchable for AI. Could you shed some insights on that?

4

Thanks for the clarification!

Do you have an estimated timeline for when the workspace files will be updated to reference the Learn site instead of the liferay-learn repository?

Also, I noticed a potential issue with the current recommendation. Even if we replace the base repository references with the Learn site, the existing structured paths (like docs/dxp/latest/en/...) don’t map directly to the website URLs, which means many of the references in CLAUDE.md and related configs would still break.

For example, paths like:

  • docs/dxp/latest/en/liferay-development/client-extensions.md
  • docs/dxp/latest/en/site-building/developer-guide/developing-page-fragments.md

don’t seem to have a direct equivalent URL structure on the Learn site.

Is there any mapping guide or updated structure we should follow for converting these repository paths to the corresponding documentation pages?

That would really help in updating things correctly in the meantime.

Thanks!

5

The workspace files are updated to use learn.liferay.com with the latest blade release (8.0.1+). If you create a new workspace with blade init you can grab the latest version of the .workspace-rules.

We are working on a new streamlined delivery mechanism for these files and planning more updates with added AI Skills.