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

Joomla Documentation Developer Portal needs to be updated #75

Open
max123kl opened this issue Jan 14, 2023 · 6 comments
Open

Joomla Documentation Developer Portal needs to be updated #75

max123kl opened this issue Jan 14, 2023 · 6 comments

Comments

@max123kl
Copy link

This issue refers to the following page in the Joomla documentation:
https://docs.joomla.org/Portal:Developers.
The portal page in the Joomla documentation does not yet contain any information specific to the J4 version and does not yet contain a reference to the https://manual.joomla.org website.

The last minor change to the page was made in Apr 2020.

I am asking for suggestions on what obsolete content should be removed and what new information needs to be added. (With a JDoc account, the wiki can also be edited directly).

@Shu12388y

This comment was marked as off-topic.

@max123kl
Copy link
Author

I'm not a maintainer of this Repo - so I've no permission to do this.
If you want to contribute to the Joomla Docs Wiki you should have an account there.
As the Dev Manual will only start with the release of Joomla 4.3 - it's no need to hurry.

@HLeithner
Copy link
Member

You miss understood the start with 4.3, it means it have to be ready with 4.3 which is released in April.

@rinka88
Copy link

rinka88 commented May 14, 2023

joomla 4.3 has already been released when the doc portal is planned to be launched

@codeling
Copy link

codeling commented Nov 30, 2023

I actually just discovered manual.joomla.org by chance through a web search, and from a first glance it looks like it could get a great source of information for Joomla extension developers, thanks!

On the abovementioned docs.joomla.org I still see no direct reference to https://manual.joomla.org? Why is that? And is manual.joomla.org actually planned as a replacement for the development portal under docs.joomla.org in the long run, or will they coexist somehow?

As a side note, api.joomla.org seems to be missing the API reference for Joomla version 5, or am I missing something here?

As an extension developer not deeply involved in the core development of Joomla, such (hopefully easily fixable) things make it a bit hard to find information on how to keep one's extensions up to date with the new versions.

@max123kl
Copy link
Author

max123kl commented Dec 1, 2023

As an entirely volunteer-supported Open Source project, Joomla! relies on users getting involved.
Unfortunately, the number of people willing to contribute to projects like Joomla! has decreased significantly in recent years.
Open Source projects thrive on give and take. If this no longer works, we will all become more dependent on commercial companies and have to bury our idea of good software.

In other words, in many places we lack the helpers to do what we want to do. So many things remain unfinished.
However, it often takes very little time to implement one of the many necessary improvements.

The dev manual was created in response to requests from developers for documentation that was easier to edit than the Jdocs wiki.
It is being developed in addition to the existing documentation.
There are also plans to complement and develop the wiki with another platform that would make it easier for users to contribute.

You are very welcome to join the discussions on the Mattermost channel and be part of the Joomla development team.

Dieter Ziller
JDocs Team Lead

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants