search

joomla / Manual

Joomla Developer Documentation
23 stars 48 forks source link

Joomla Documentation Developer Portal needs to be updated #75

Open max123kl opened 1 year ago

max123kl commented 1 year ago

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 commented 1 year ago

Hi shubham here, can i work this issue can you assign this issue to me

max123kl commented 1 year ago

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 commented 1 year ago

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

rinka88 commented 1 year ago

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

codeling commented 7 months ago

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 commented 7 months ago

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