search

max123kl / J4.docs

Joomla 4.x Documentations preliminary tasks
GNU General Public License v2.0
0 stars 3 forks source link

Custom Fields Tutorial - Introduction #23

Open alann60 opened 1 year ago

alann60 commented 1 year ago

Document Purpose

This is the first of series of tutorials about the different types of Custom Fields in Joomla! 4.

Instructions

A series exists for Joomla 3. Follow the format to recreate and align with the Joomla 4 version.

Supporting Information

A list of Joomla 3 links can be found at https://github.com/max123kl/J4.docs/blob/main/J4_JDocs/Supporting_Documents/j4x_custom_fields_tutorial_series.md

ceford commented 1 year ago

Can you explain more clearly what this issue is. It says "started". Does that mean by you? And Document Text Complete - is that the list? The issue title implied the issue was about an Introduction document. What happens next?

alann60 commented 1 year ago

@ceford under the assumption this repo was for testing ideas, this issue is raised only to understand how a template might look and status types that will reflect progress when the task is viewed on a project board. @max123kl has already proposed some status steps but, it may be that tasks for the different document bases may vary in the steps required.

Given that currently the Joomla project encourages participation and contributions, however small and that MediaWiki templates are often in place inviting participation on documents, stages are useful for people to cast their eyes over issues without having to open up individual ones, bearing in mind that if the proposal is for an issue for each document there could be many issues at any one time. In an ideal world one writer will see each issue through themselves.

As I've not yet got access to the new repository that @carlitorweb is controlling access to, I would not be doing this type of work there anyway. Dieter has contacted me regarding that repo. In the meantime I will stop working in this repo to avoid any confusion.

Off topic but it is obvious I have not sufficient time available to effectively participate in conversations as and when they are happening so my usefulness here might not meet expectations. For the same reason, I do not wish to become a team member as I would feel that without time there is no effort and therefore not be a viable team member. I do though want to help in any way I can.

ceford commented 1 year ago

@alann60 I appreciate you have limited time available. Much of our recent discussion has been about how to manage contributions to the documentation. If you have a few hours to spare now an then you could just tackle a document that needs work. For example, you could create J4 versions of the list you made. Go to a document, change 3 to 4 in your url bar and create it. Copy the source content from the original and remove all translation markup and add an {{underconstruction}} template. Then start changing whatever needs to be changed for J4.

I am so used to doing that first step I could probably do it for all 22 articles in a few hours if that would help. I just copy the source to VSCode to do the initial editing. I am familiar with regular expressions, which makes removing translation markup fairly easy.

alann60 commented 1 year ago

Thank you @ceford I can pick up that work. I am curious though on the regular expressions you mention. I use VS code but haven't used regular expressions. I remove the translation markup one by one so it could be a real time saver knowing how to do it!

Without taking up too much of your time I'd appreciate you pointing me in the right direction regarding as to how?

ceford commented 1 year ago

Tricky! In the Edit / Find box type and then click the third icon at the end of the box. You can also practice using this site: https://regex101.com/

alann60 commented 1 year ago

Thanks @ceford It will probably take me longer working it out initially than it would to remove them manually but it's got to be worth it!