Page 1 of 1
[Solved] Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 11:42 am
by Hagar Delest
I was wondering if we needed all the rather complex structure of the Macro sections.
Today there is the main section Macros and UNO API with 3 subforums
- OpenOffice Basic, Python, BeanShell, JavaScript
Keyboard macros or custom scripts
- External Programs
Java, C++, C#, Delphi, ??? - Using the UNO bridges
- UNO API and ODF
The Application Programming Interface and the OASIS Open Document Format
The first subforum has only 30 pages (110 for the parent section) and is redundant IMHO with the parent section. I always struggle to evaluate in which section a simple topic should be moved to.
Ideally, I think that we had in mind to have no topic in the parent section and all the actual discussions in the subforums (like the Customizing and Extending main forum). But we should have configured the parent section the same way, forbidding the posting there. But if we want to keep it simple, I'm not sure it would really help.
Thus, we could move all the topics from the OpenOffice Basic, Python, BeanShell, JavaScript section in its parent forum and remove this subforum. Leaving only 2 subforums for rather specific questions.
Thoughts?
Re: Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 11:55 am
by DiGro
I agree

Re: Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 12:26 pm
by RoryOF
Agreed
Rory
Re: Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 4:28 pm
by FJCC
I agree. That subforum is redundant and confusing.
Re: Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 5:53 pm
by Hagar Delest
Thanks for the feedback.
I have applied the change. No need to wait for further comments I think.
I have slightly change the description of the parent forum then: Creating a macro - Writing a Script - Using the API (OpenOffice Basic, Python, BeanShell, JavaScript) or External Programs (Java, C++, C#, Delphi...).
Let me know if it has to be improved.
Re: Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 5:55 pm
by Hagar Delest
Thanks for the feedback.
I have applied the change (some forum housekeeping during the holidays). No need to wait for further comments I think.
I have slightly change the description of the parent forum then: Creating a macro - Writing a Script - Using the API (OpenOffice Basic, Python, BeanShell, JavaScript) or External Programs (Java, C++, C#, Delphi...).
Let me know if it has to be improved.
Re: [Solved] Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 6:50 pm
by DiGro
Thanks for that. Looks good to me.
Re: Rationalization of the Macro forum sections
Posted: Sun Dec 24, 2023 6:59 pm
by MrProgrammer
Hagar Delest wrote: ↑Sun Dec 24, 2023 11:42 am
I always struggle to evaluate in which section a simple topic should be moved to.
I have some trouble with this too but have tried to put topics in:
•
Macros and UNO API when the focus of the question is the API
•
OpenOffice Basic, Python, BeanShell, JavaScript when the focus is using one of the languages
•
External Programs when the focus is calling OpenOffice from the outside
•
UNO API and ODF when the focus is Open Document Format generally
The bigger question is:
What do we really want and how can we achieve it?
Some of these forums have many topics:
•
Macros and UNO API about 5600
•
OpenOffice Basic, Python, BeanShell, JavaScript about 1500
•
External Programs about 600
•
UNO API and ODF about 300
Edit: Oops: Looks as if the first two of these were just merged. I will continue with my post anyway. |
I will suggest this arrangement (some of the titles are altered a bit):
•
Programming Programming with OpenOffice and LibreOffice
(users cannot create topics here)
•••
Macros in Basic, Python, BeanShell, JavaScript Perform tasks with a macro
•••
UNO API Use the API to work with documents
•••
External Programs Call OpenOffice externally
•••
Old topics Temporary for pre-2014 topics
(users cannot create topics or post here)
For users, there are only three sub-forums to choose from when creating a topic.
How do topics get there?
•
Macros and UNO API Everything moved out, as explained below
•••
Macros in Basic, Python, BeanShell, JavaScript Existing
OpenOffice Basic, Python, BeanShell, JavaScript topics
•••
UNO API Post-2013 topics from
Macros and UNO API or from
UNO API and ODF
•••
External Programs Existing
External Programs topics
•••
Old topics Pre-2014 topics from
Macros and UNO API or from
UNO API and ODF
The last category is to help us perform the reorganization and may eventually go away. There is certainly value in these topics, but most of the pre-2014 topics will be for OpenOffice.org before we had Apache OpenOffice or LibreOffice, thus the topic may no longer be relevant to those suites. I would help by moving, as time permits, topics from it to the first three sub-forums. This might take me a year or so, depending on how many others help with the process.
I realize there can be a lot of overlap between writing a macro and using the API. We can combine those sub-forums, but we risk making the merged pool of topics more difficult to use for our users.
Being unfamiliar with
Administrator capabilities I don't know how feasible it is to split out the old topics, but I think that would help us achieve the desired final goal state.
Re: [Solved] Rationalization of the Macro forum sections
Posted: Mon Dec 25, 2023 12:00 pm
by Hagar Delest
Well, I'm not fond of the forums where you can't post (like customizing and extending). It is not very user friendly because it leads users to go one level deeper, not always realizing that they cannot post in that area.
For the old topics, indeed, many do not apply anymore but well, that's true for many other topics (be it about macros or not). Not sure it's worth the energy to sort them. They will be ranked in the latest hits for any search, and users may be aware from the posting date that the information is likely to be deprecated. Or they would try to find how to adapt the information to the more recent versions.
I would prefer to reduce the number of levels. Maybe move the one for External programs in parallel to Macros and Code snippets and Extensions?
And for the UNO API and ODF, does it really deserve a forum? There are only 300 topics there and quite a few should be moved in the Macro forum. For example I moved this one:
viewtopic.php?t=94763. Or it could be moved in parallel of the others, too. That would give a "flat" structure. Even if that forum is not really used, it would simplify the structure, most users now going directly to the Macros section.
Re: [Solved] Rationalization of the Macro forum sections
Posted: Mon Dec 25, 2023 7:21 pm
by MrProgrammer
Hagar Delest wrote: ↑Mon Dec 25, 2023 12:00 pm
And for the UNO API and ODF, does it really deserve a forum?
Given the present structure of the
Customizing and Extending section I think it would be better to move all the topics from
UNO API and ODF to
Macros and UNO API and eliminate
UNO API and ODF. Both mention
UNO API in the name and people (including me) will not understand where to put topics.
Hagar Delest wrote: ↑Mon Dec 25, 2023 12:00 pm
Maybe move the one for External programs in parallel to Macros and Code snippets and Extensions?
Yes! We should move
External Programs somewhere else so we have no sub-forums of
Macros and UNO API. My vote would be to have:
• Customizing and Extending
••• Macros and UNO API
••• Code Snippets
••• Extensions
••• External Programs
This would be a much less confusing struture. As long as we are doing some year-end cleanup, I have also wondered why we have this:
• Getting started
••• Survival guide
••• Beginners
••• Install, Setup and Troubleshooting
••••• MS Windows
••••• Linux
••••• Mac OSX
••••• LibreOffice
••••• Tablets
••• Tutorials
••••• Writer
••••• Calc
••••• Base
••••••• Database Examples
Database Examples is a sub-forum of
Base in
Tutorials in
Getting Started, quite a deep level, and the only one at that level, I believe. I recommend we move
Database Examples to
Base in
Applications. I don't view the examples as tutorials.
• Applications
••• Writer
••••• Templates
••••• Advanced Uses
••• Calc
••• Impress
••• Draw
••• Math
••• Base
••••• Tables & Queries
••••• Forms
••••• External Data Sources
••••• Reporting
••••• Database Examples
Re: [Solved] Rationalization of the Macro forum sections
Posted: Mon Dec 25, 2023 8:17 pm
by Hagar Delest
Agreed. I've added a sticky in the tutorial section for Base tutorials pointing to the examples.