A TiddlyWiki for Dummies series ...

[S. S.]

So many have said TiddlyWiki MUST HAVE THIS.

So if it is wanted, How should the series be named?

Some suggestions:

An Introduction to Widgets	Widgets - An Introduction
An Intro to WikiText	Wikitext - an Intro
	Tiddlers for Beginners
GettingStarted - Macros	Macros - GettingStarted
Get Started with Templates	Templates - Get Started
A Guide to Tags	Tags - A Guide
Understanding Filters	Filters - Understanding

At this point - a decision needs to be made.
There was some "lively discussion" last month leading to the above results: Here

It's difficult to decide; there are many who have experience.
If we can't decide, we won't have this any-time soon!

I search for documentation multiple times a day.
For reasons stated in the "lively discussion" my preference is:
An Introduction to . . . ( or )  An Intro to . . .

Main reason why: Alpha sorting when searching brings "An" near the top of the list.

What's yours - and if possible, why?

P.S. Jeremy has an opinion different from mine. If his suggestion is to be taken, my choice would be in the form: Tiddlers for Beginners

[Mark S.]

 How about

* Tiddlers for Beginners

Then it will sort to the top, but have the preferred naming convention.

-- Mark

[Lost Admin]

"Saving Your First TiddlyWiki" should be the #1 tutorial for beginners.

There are so many choices with their own advantages and limitations. A beginner doesn't need to know all of them. A beginner needs to know the easier options and where to learn about all the other options.

[Mohammad]

Great job S.S

I may prefer a simpler learning resource for beginner.

Beginners need only to do basic things in Tiddlywiki

1. Tiddlywiki structure
2. Tiddler concept
3. Save Wiki
4. Wikitext
5. Tables
6. Images
7. Tags
8. fields
9. dictionary tiddlers
10. advances search (simple filters, like [tag[myTag]]
11. simple macros
12. Table of contents

--Mohammad

[Thomas Elmiger]

Hi

Interesting and important questions. Some thoughts.

===

Beginnerʼs Guide: Saving

Beginner: That's what I am
Guide: That's what I need

===

How big could this get?
- tiddlers on tiddlywiki.com
- Beginnerʼs Guide Edition
- Video series
- ...

===

Learning curve

1. Beginner => Beginnerʼs Guide
2. Advanced user => (?) tiddlywiki.com
3. Developer => Developer Documentation (tiddlywiki.com/dev)

===

How would we distribute this info in TW elements?

Tag: BeginnersGuide
Title of wiki: Beginnerʼs Guide
Tiddler title: Chapter 1
Start of text field: !!! Saving
Caption: Saving
Description: Saving your wiki on a computer locally

===

Search: "beginner" produces only 2 results at the moment. One tiddler "Beginnerʼs Guide" would be enough. It could contain the table of contents (TOC) and/or a link to the edition. It could also serve as a sidebar tab. The toc would display captions not tiddler titles.

===

Keep it simple!

All the best,
Thomas

[S. S.]

Thanks Thomas & others.

I played with the idea of Chapters. It is a workable idea for an independent TW but I felt it would get lost within the 1,500+ info tiddlers on tiddlywiki.com

I'm a little stuck on naming the series (& thus each tiddler in the series).

All the tiddlers I have made use the title format   . . . . . .  for Beginners
I feel very comfortble with this name.
After spending time thinking about WHO the tiddlers are being written for . . .
I feel most of those attracted to, and using TiddlyWiki are basically not "programming illiterates."
Thus I began to feel "Beginners" was a bit off putting, maybe even condescending.
So I have been toying with the idea of   An Introduction to . . . . . .

How the series will be presented (distributed) on tiddlywiki.com (ToC or separate tab or list-links etc.) will be an issue later.
I think maybe I should first get all the tiddlers onto the website, then work more on how to present them properly.

Before I can make a proposal on Github to include these in tiddlywiki.com I feel I have to finalize the naming scheme.

I've been stuck on this for over a month now.

I need MORE feedback!

On Wednesday, March 6, 2019 at 3:07:16 AM UTC+7, Thomas Elmiger wrote:

Hi

Interesting and important questions. Some thoughts.

. . .

[Birthe C]

I do not understand why you find "Beginners" off putting. No matter who you are and what you know, if you haven't used Tiddlywiki before, you are new to Tiddlywiki = beginner.

I know absolutely nothing about programming. I have used Tiddlywiki for many years now mostly because I had a very good teacher (Måns). Tiddlywiki is so wonderful, it should really be for everyone, but people like myself need all the help they can get. (Beginners Guide). The difference will be the time they use going through your guide, at least I think.

Do you know people never reading manuals? They are often the people who think they know it all.....think it is sooo easy, nothing to it. You can not write a Guide for them.

Beginner can be a friendly and welcoming word to new users, as in this is also for you, no expectations of programming skills.

Birthe

[@TiddlyTweeter]

"Beginner" looks fine to me.

Birthe, I agree with everything you wrote about this.

Josiah

[S. S.]

Thanks for this perspective Birthe!

[S. S.]

It appears it falls onto me to make a decision on how to name the series, and we will just have to live with the consequences.

When I started writing this documentation, I felt it was for non-programmers. Along the way, I slowly swayed over to the belief that it would be better if it was for those who has some experience coding. Then the post by Birthe last week put things back into perspective (and made me laugh):

I do not understand why you find "Beginners" off putting. No matter who you are and what you know, if you haven't used Tiddlywiki before, you are new to Tiddlywiki = beginner.

I know absolutely nothing about programming. I have used Tiddlywiki for many years now mostly because I had a very good teacher (Måns). Tiddlywiki is so wonderful, it should really be for everyone, but people like myself need all the help they can get. (Beginners Guide). The difference will be the time they use going through your guide, at least I think.

Do you know people never reading manuals? They are often the people who think they know it all.....think it is sooo easy, nothing to it. You can not write a Guide for them.

Beginner can be a friendly and welcoming word to new users, as in this is also for you, no expectations of programming skills.

Note: Bold formatting above added by me.

It also reminded me of Jeremy saying somewhere:

TiddlyWiki wasn't put together and designed for developers. Software developers are already incredibly well catered for by the open source world. This program explores how the non-developer can be empowered.

So I have gone back to the basic reason I started writing this series, and will name it:

TiddlyWiki for Beginners

[Mohammad]

S.S 

Where is the latest update?

I believe you need a little knowledge of programming (coding) to use TW effectively!

Writing a small scripts like

<$list filter="[tag[xx]remove[z]]>

...

</$list>

Needs a small knowledge of programming!

--Mohammad

[Thomas Elmiger]

Glad to hear that! 

Some concepts of TW are hard to grasp, especially for people with some programming experience — so I share the belief, that everyone starting with TiddlyWiki is a beginner. 

Cheers, 

Thomas 

[S. S.]

Thanks Thomas! Glad to hear using "Beginners" is acceptable!!

Mohammad,

Where is the latest update?

 

Recently, spare time was spent on Anchor Links using HTML so not much progress on updating the Beginner's series.
At the same place all this started, I keep the TiddlyWiki up to date with all changes:
https://00ss.github.io/help/Adding-a-table-of-contents-to-the-sidebar.html

Regards.

[Mohammad]

Thank you S.S.

--Mohammad

[Birthe C]

Hi S.S,

In your tiddler Download and Get TiddlyWiki, the big green button Download Empty does not work. It seems as working, but the downloaded file empty.html is zero bytes. Going to https://tiddlywiki.com/empty to get the empty file has the benefit of showing only the GettingStarted tiddler. Having set your title and subtitle it is really nice to use https://tiddlywiki.com/#Hidden%20Setting%3A%20Filename%20for%20Save%20Wiki%20Button Avoiding ending up with empty.html, empty(1).html and so on. Having done that you save.....everything ready to go. I really think that config tiddler should follow the GettingStarted tiddler

Birthe

[S. S.]

Thanks Birthe.
That's a good idea & I will try and incorporate it.

Meanwhile the documentation development Tiddlywiki Mohammed asked to see and that you looked at will behave a little differently than if those tiddlers were on tiddlywiki.com

It's also very much "work in progress" with many gaps to fill.

Once necessary supporting changes are finalized and accepted I will polish them up!

Cheers