Proposed Joomla User Manual

Joomla! Documentation Workgroup

Moderator: Documentation

Post Reply
User avatar
ceford
Joomla! Ace
Joomla! Ace
Posts: 1331
Joined: Mon Feb 24, 2014 10:38 pm
Location: Edinburgh, Scotland
Contact:

Proposed Joomla User Manual

Post by ceford » Fri Sep 30, 2022 12:26 pm

I propose to create a new Joomla User Manual aimed at Joomla 4 and later by creating new documents from merged and revised existing tutorials and similar documents from docs.joomla.org. The initial list of sections and contents is available here:

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

Amongst other things I propose to simplify translation markup by having only one pair of <translate>...</translate> tags at the top and bottom of each document. Segmentation would then occur naturally at blank lines.

The objective is to create something that can be delivered either in the Wiki or in Joomla or in Docusaurus (or anything else).

Comments are welcome.

User avatar
toivo
Joomla! Master
Joomla! Master
Posts: 15221
Joined: Thu Feb 15, 2007 5:48 am
Location: Sydney, Australia

Re: Proposed Joomla User Manual

Post by toivo » Fri Sep 30, 2022 12:48 pm

Thank you @ceford! The list of contents looks impressive.

The recently added pages How to debug SMTP mail in Joomla 3 and How to debug SMTP mail in Joomla 4 would probably go under the heading Problems.
Toivo Talikka, Global Moderator

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

Re: Proposed Joomla User Manual

Post by ceford » Fri Sep 30, 2022 1:11 pm

toivo wrote:
Fri Sep 30, 2022 12:48 pm
The recently added pages How to debug SMTP mail in Joomla 3 and How to debug SMTP mail in Joomla 4 would probably go under the heading Problems.
@toivo Thank you for that. I have put the J4 link in Configuration next to the one on using GMail with the intention of merging them into a single article. There are a lot of links to J3 articles where there are no J4 equivalents. Again, the intention is to produce new revised versions for J4 only.

gsmela
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 223
Joined: Thu Jun 10, 2010 12:38 pm
Contact:

Re: Proposed Joomla User Manual

Post by gsmela » Fri Sep 30, 2022 5:54 pm

@ceford, that looks fantastic. Thank you for this.


Post Reply

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