Josiah,

I agree, but I suppose in my last post I was endevoring to start this 
documentation

*An application that includes the ability to build custom macros empowers 
the users and designers of solutions in that application with almost 
unlimited possibilities. Custom macros allow the encoding of additional 
logic, manipulating what is displayed and allows you to build your own 
algorithms into the application. Custom macros acknowledge your needs may 
differ from the application designers perceived needs. Effective custom 
macros can encode logic, manipulate sets, do maths and support interfaces 
with users, to simplify everyday use. *

*TiddlyWiki's custom macros Exceeds the capabilities of many macro 
solutions. In addition there is a community behind this and many macros are 
commonly shared with many also being moved into plugins or add ons.*

Something like the above should be placed at the top 
of https://tiddlywiki.com/#Macros

The fact is tiddlywiki.com is too fast at reverting to its own jargon 
describing almost everything. 

Just look at https://tiddlywiki.com/#Macros as an example, the first 
paragraph includes
*snippet, WikiText <https://tiddlywiki.com/#WikiText>, transcluding 
<https://tiddlywiki.com/#Transclusion>, macro calls, parameters, 
substituted, placeholders*

This is detail, not a description or introduction. We need a lot more 
friendly text.

Regards
Tony

On Wednesday, April 3, 2019 at 10:12:56 AM UTC+11, @TiddlyTweeter wrote:
>
> TonyM, footnote ...
>
> I very much doubt a beginner would currently easily understand the sheer 
> flex in macro syntax in TW. I don't see any documentation that deals with 
> this?
>
> Best wishes
> Josiah
>
> On Wednesday, 3 April 2019 00:42:33 UTC+2, TonyM wrote:
>>
>> Josiah,
>>
>> In some ways as soon as an application claims to have custom macros 
>> available it advertises flexibility. Just look at other applications in the 
>> market, few have custom macros but many promise addins, sometimes these add 
>> ins are not very helpful, but they are trying to compete with other 
>> solutions that empower the users with custom macros. It is true us 
>> TiddlyWiki enthusiasts come to learn this flexibility is enormous and other 
>> may miss the value to custom macros.
>>
>> I suppose what I am saying is without getting into too much TiddlyWiki 
>> details promoting the value of custom macros generally then pointing out 
>> how well tiddlywiki can implement them may be a good strategy.
>>
>> *An application that includes the ability to build custom macros empowers 
>> the users and designers of solutions in that application with almost 
>> unlimited possibilities. Custom macros allow the encoding of additional 
>> logic, manipulating what is displayed and allows you to build your own 
>> algorithms into the application. Custom macros acknowledge your needs may 
>> differ from the application designers perceived needs. Effective custom 
>> macros can encode logic, manipulate sets, do maths and support interfaces 
>> with users, to simplify everyday use. TiddlyWiki's custom macros Exceeds 
>> the capabilities of many macro solutions. In addition there is a community 
>> behind this and many macros are commonly shared with many also being moved 
>> into plugins or add ons.*
>>
>> By promoting the concept of the flexibility of macros generally, then 
>> demonstrating the power of TiddlyWiki macros specifically I think we could 
>> persuade and compete with other solutions effectively. 
>>
>> Why should we try and persuade people to use tiddlywiki, because every 
>> new enthusiast brings new ideas and skills to the community as a whole. A 
>> Community I have always treasured, but still in a position to grow and open 
>> up further.
>>
>> Regards
>> Tony
>>
>>
>> On Wednesday, April 3, 2019 at 3:57:52 AM UTC+11, @TiddlyTweeter wrote:
>>>
>>> The <<myThingie>> macro might be more flexible than you think.
>>>
>>> One of the things in macros is SYNTAX. In TW I think @Jermolene 
>>> <https://twitter.com/Jermolene> fell over himself on flexibility in 
>>> designing macro syntax.
>>>
>>> It took me 1.783 years to understand how flexy macro syntax is.
>>>
>>> It that FLEX documented?
>>>
>>> Best wishes
>>> Josiah
>>>
>>

-- 
You received this message because you are subscribed to the Google Groups 
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/68dc93dc-6ed4-4b92-bd42-aecf31fdd3fe%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to