Joomla docs uneditable

Joomla! Documentation Workgroup

Moderator: Documentation

Post Reply
User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Joomla docs uneditable

Post by Webdongle » Mon Jun 05, 2023 10:24 am

Parts of the Docs are now uneditable. This is against the whole concept of why the wiki format was chosen. example https://docs.joomla.org/index.php?title ... ection=T-1
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
ceford
Joomla! Hero
Joomla! Hero
Posts: 2021
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Re: Joomla docs uneditable

Post by ceford » Mon Jun 05, 2023 12:03 pm

Actually, you have misunderstood the way editing translations work. Your link quoted the English version of the page. That contains the text without translation markup and is indeed not editable. To edit the English version you must edit the version without a language suffix:

https://docs.joomla.org/index.php?title ... _Overrides

After editing that version must be marked for translation - that action creates or updates the /en version.

But there is something else wrong here: that url does not conform to the convention for naming Chunks. All those I know of have the Chunk3.x namespace (or Chunk4.x). Where did you find it?

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Tue Jun 06, 2023 9:26 pm

@Ceford
Perhaps I haven't explained properly.

https://docs.joomla.org/Help310:Extensi ... _Overrides
Create Overrides[edit]

Click on a component and you'll get all the possibilities inside that one component.
When I click to edit it takes me to https://docs.joomla.org/index.php?title ... ection=T-1
I can not edit
"Click on a component and you'll get all the possibilities inside that one component"
to read
"Click on a Component, Module, Plugin or Layout you will get all the possibilities inside that extension"
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
cmbay
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 237
Joined: Thu Dec 31, 2009 11:53 pm
Location: Oregon, USA

Re: Joomla docs uneditable

Post by cmbay » Tue Jun 06, 2023 9:58 pm

Do you have permission to edit in the Template namespace? Parenthetically I note that the FuzzyBot has been involved in the past.
Charles

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Tue Jun 06, 2023 11:45 pm

cmbay wrote:
Tue Jun 06, 2023 9:58 pm
Do you have permission to edit in the Template namespace? ...
No doubt that is a rhetorical question.

The whole point of this post is to point out that the Wiki used to be editable by all members but now that is not the case.
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
ceford
Joomla! Hero
Joomla! Hero
Posts: 2021
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Re: Joomla docs uneditable

Post by ceford » Wed Jun 07, 2023 8:38 pm

I see your point. It is a while since I edited a chunk so I don't remember if it used to be different before a Wiki update a year or so ago. The chunk does contain some explanation: This page cannot be updated manually.. What you have to know is that you need to remove /en from the url to get the editable source.

Most of the Help screen chunks I am familiar with do not start with a header - you just see them as {{Chunk...}} embedded in the text. Perhaps this is no bad thing because editing chunks needs care - each is typically embedded in several pages, which is why they are chunks.

I think this is a failure of documentation. You can edit if you know how to!

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Wed Jun 07, 2023 9:22 pm

ceford wrote:
Wed Jun 07, 2023 8:38 pm
.... What you have to know is that you need to remove /en from the url to get the editable source....
Nope doesn't work like that. I challenge you to give an editable link for that section
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
ceford
Joomla! Hero
Joomla! Hero
Posts: 2021
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Re: Joomla docs uneditable

Post by ceford » Thu Jun 08, 2023 11:18 am

Webdongle wrote:
Wed Jun 07, 2023 9:22 pm
ceford wrote:
Wed Jun 07, 2023 8:38 pm
.... What you have to know is that you need to remove /en from the url to get the editable source....
Nope doesn't work like that. I challenge you to give an editable link for that section
The editable link is:

https://docs.joomla.org/Template:Chunk3 ... _Overrides

This page was created in October 2021 and has the wrong prefix. It is a mistake! I don't touch anything from the J3 era but you can find it here:

https://docs.joomla.org/Special:PrefixI ... mespace=10

All of the Joomla 3 chunks should be in this list:

https://docs.joomla.org/Special:PrefixI ... espace=140

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Thu Jun 08, 2023 12:01 pm

https://docs.joomla.org/Template:Chunk3 ... _Overrides is not editable!!!
The edit link leads to https://docs.joomla.org/index.php?title ... &section=1
I am logged in but do not have permission to edit. That means that the page is not editable by many members.

The same is true of many of the name spaces. The whole idea of the wiki was that any member could add to it. That is no longer the case.
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
ceford
Joomla! Hero
Joomla! Hero
Posts: 2021
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Re: Joomla docs uneditable

Post by ceford » Thu Jun 08, 2023 4:51 pm

I can edit the pages you provided links for. Can you indicate what you see that stops you editing? Can you go to your User Preferences page and tell us which Groups you are a member of? I am in:

Code: Select all

Member of groups: Autoconfirmed users, Translation administrators, JDOC Contributors, Users, Email Confirmed

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Thu Jun 08, 2023 5:22 pm

You do not have permission to edit pages in the Template namespace.
But that is my point. If I don't have permission then many members don't. The whole point of the wiki was that members could add to the documentation. But that is not the case now. Many parts of the wiki are uneditable by ordinary members.
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
ceford
Joomla! Hero
Joomla! Hero
Posts: 2021
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Re: Joomla docs uneditable

Post by ceford » Thu Jun 08, 2023 6:08 pm

Webdongle wrote:
Thu Jun 08, 2023 5:22 pm
You do not have permission to edit pages in the Template namespace.
But that is my point. If I don't have permission then many members don't. The whole point of the wiki was that members could add to the documentation. But that is not the case now. Many parts of the wiki are uneditable by ordinary members.
I see now! The Template namespace is reserved. It is only supposed to be used by those with higher authority who know what they are doing. It is supposed to be used for items such as the {{inuse}} or {{underconstruction}} templates. Not for article content or chunks. As I said previously, creating this chunk with this prefix was a mistake (not by me). I could change the namespace to make it editable by normal users. But I would also have to check all the ramifications and I don't usually touch J3 stuff. Do you actually want to edit this Chunk?

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Thu Jun 08, 2023 7:07 pm

I did but not bothered. I don't add much to the wiki so it's not important to me. However it kind of makes a mockery of open source. Yet another step that lessens the contributions of ordinary members.

I've tried making my point several times but it has turned into "There's a hole in my bucket dear lisa" conversation.
http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
Hotdog
Joomla! Apprentice
Joomla! Apprentice
Posts: 21
Joined: Sun Jul 23, 2023 7:15 pm

Re: Joomla docs uneditable

Post by Hotdog » Sat Aug 05, 2023 5:43 pm

I want to help with documentation but am very new at it. So far, I limit my efforts to spelling, basic grammar, etc. Is there some description or tutorial regarding documentation? For example, what are "chunks"?

User avatar
Webdongle
Joomla! Master
Joomla! Master
Posts: 42902
Joined: Sat Apr 05, 2008 9:58 pm

Re: Joomla docs uneditable

Post by Webdongle » Sat Aug 05, 2023 10:10 pm

http://www.weblinksonline.co.uk/
https://www.weblinksonline.co.uk/updating-joomla.html
"When I'm right no one remembers but when I'm wrong no one forgets".

User avatar
ceford
Joomla! Hero
Joomla! Hero
Posts: 2021
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Re: Joomla docs uneditable

Post by ceford » Sun Aug 06, 2023 6:32 am

Useful list of articles on Joomla documentation:

https://docs.joomla.org/J4.x:Documenter_Links


Post Reply

Return to “docs.joomla.org - Feedback/Information”