Good Wiki Practices

Hello all,

I am trying to create a knowledge base that will eventually evolve into microcopy instructions for onboarding new users into TiddlyWiki and Wikis in general (in support of my own oneplaybook project). I have some notes that act as the stub for this effort that you can read here. I’d like your comments as well as any additions in this regard: what do you think are the most fundamental key concepts practices (e.g. Generally Accepted Accounting Principles in bookkeeping or Good Clinical Practices in medicine and medical research) that would get a naive user from zero to hero when using TiddlyWiki and how would you recommend integrating it into TiddlyWiki’s UI UX?

I have some ideas for some good wiki practices, but I’d like to know your thoughts on them. These are rules that I adhere to myself, but I don’t want them to be opinionated; I’d like them to evolve into a broadly acceptable and accessible set of universal rules that can encompass most of the general use case scenarios that TiddlyWiki can support.

Here’s a high level view of these good wiki practices points from the notes.

  1. Note/page titles should always be exhaustively descriptive

  2. Tagging should be done as much as possible

  3. Link wherever possible

  4. Automate wherever possible

  5. Codify and compress as much as possible

  6. Make everything accessible

  7. Make everything as interoperable, integratable and extendable as possible

Click here to explore some of the detail underlying each bullet point. I believe these good wiki practices are also applicable to TiddlyWiki developers.

Many thanks.

3 Likes

Hi

I don’t think there are absolutes or easy quick guides, it’s a matter of experience and discovering what you want out of it.

I think most of the “as much as possible” statements are questionable - tagging should be done intelligently - you don’t want a soup.

I admire your enthusiasm to get it “right” but I think your idea of “right” may change as you progress.

Good idea. I think much of the docs is overwhelming for new users so identifying a subset of the docs makes sense.

There is the concepts list. Many of the identified ones in that list are fundamental but quite a few are not, IMO. Is it these “concepts” you refer to @abesamma ?

I think it could be helpful for beginners if some of the more fundamental concepts there were marked out, like has been done in the Filter Operators list.

But your hour headline reads “Good Wiki Practices” and half of your OP seems to request more hands on practices (rather than “concepts”) so here are a few haphazard tidbits:

  • Learn to use the listwidget
  • Very soon: Learn to use procedures (if that will be the term - I’m referring to the successor to macros)
  • Learn about conditional viewtemplates. Not as the first thing you do but pretty soon, so e.g all tiddlers tagged x will behave in some certain way.
  • Turn off CamelCase linking. IMO it is a leftover idea from the early 2000 that causes problems.
  • Turn on “Tiddler Titles display as links” is active (Ctrlpanel > Settings).
  • Sign up on tiddlyhost
  • Do ask in the forums. And understand that the best way to explain your problem is by showing it (e.g via tiddlyhost).
  • Speak up about what can be improved with TW. Especially what you get stuck on as a beginner.
  • Share your joy with others whom you think might benefit from TW. The more we are the better TW becomes.
1 Like

I don’t think there are absolutes or easy quick guides, it’s a matter of experience and discovering what you want out of it.

I agree :100:. As I mentioned above, these are opinionated rules that I have come up with after more than 4 years of using TW5 almost everyday at work and for personal use. I would like to evolve them into something we could use for new users because from my own user research, new users struggle a great deal when they’re asked to explore TW5’s capabilities. This holds back the platform. Some hand holding is essential and that’s what we should strive to offer. From those wiki practice essentials, a reasonably guided user should be able to take-off and discover other idiosyncratic possibilities that may suite their needs.

I think most of the “as much as possible” statements are questionable - tagging should be done intelligently - you don’t want a soup.

Agreed. Tagging should be done lightly BUT deliberately. Start with a broader, generic category tag (like Content), then progress to finer, more descriptive tags allows for more flexible indexing and resurfacing of old knowledge IMHO. I’m open to hear what others have to say in this regard.

…your idea of “right” may change as you progress.

Correct. I came up with these suggestions for good wiki practices purely out 4 years of trial and error. Many users simply do not have that much time to evolve their own practices. They have too much on their plate as it is. This is an attempt to bootstrap their wiki practice so they can just focus on their work.

Thanks for pointing this out @twMat. I have clarified in the original post that I’m looking for fundamental practices (how to) rather than concepts (what is). Think of it as a userflow onboarding demonstrating fundamental features of TW5 and how to use them effectively without being too opinionated. Does that make sense?

Yes @twMat. Every industry and domain has good practices that are recommended for all to follow. For example, in medicine and medical research in general, we have good clinical practices. In accounting, we have Generally Accepted Accounting Principles. So we should have Good Wiki Practices that are generally acceptable that can guide new users to maximize the utility of their wiki.

Why do you recommend this as a good practice? I haven’t set this on any of my wikis and maybe just don’t know what I’m missing.

If you link, those links will break when a title changes. So my rule has been to link as little as possible. If you install the relink plugin, then links become viable and useful. I would be more comfortable if relinking was part of the core, though.

Coming up with good titles is time-consuming. If you’re trying to take notes in a hurry, you will probably need to go back to your original titles many times. If you come up with an over-all strategy for how you will be using TW, it helps creating good titles the first time. Guess I should write-up the various strategies some time.

There are actually, AFAIK, only two officially recommended best practices:

Semantically meaningful units

The first rule of TiddlyWiki

I think every thing else will end up being dependent on use-case.

There is a point that I don’t understand. You are talking about new user and you give these practices to them, but there are practices for advanced users. I think it can be counterproductive.

1 Like

Yes, relinking should definitely be part of core I think. I admit, breaking links is unavoidable without it. This is why I prefer using tags more often than links because that affords you more flexibility.

Yes, but if there is anything worth getting right the first time, it’s titles. Coming up with descriptive titles on the fly is not easy, but if you write small tiddlers, it’s easier than one might think.

1 Like

How could I forget these two :sweat_smile: very important ones. Yes, IMO we need to expand on this list.

That’s an interesting thought, but I find camelCase linking quite nice as a quick means of linking. I can’t see this becoming a generally accepted practice.

1 Like

OK, it’s not the most critical practice, but it simplifies drag’n dropping tiddlers between wikis. It also lets you more easily get the tiddler to the top of viewport (if it is mid viewport) because you can click the title directly on the tiddler.

2 Likes

Fair enough. I find it causes problems like “links inside links” or “links inside buttons” etc. And if you turn it off, then what were links are no long er such both for you and for some who imported your tiddler. Besides, for people who are not used to it, i.e the majority of the world, it is weird to ReadThis (“Can he not spell? Is it some unhinged autocorrect?”)

1 Like

I’m focusing on new users yes, but we should probably expand further to include power user recommendations. For now, these are just notes from brainstorming.

1 Like

You’re probably right yes. I wonder how many in this forum use camelCase linking. We should probably do a poll in the future.

If you plan on having a lot of definitions + additional content, make heavy use of a summary field.

You can have the basic definition of a term in the field and use that field in lists or transclusions:

<dl>
<$list filter="[tag[vocab]]">
<dt>{{!!title}}</dt>
<dd>{{!!summary}} <$link>&hellip;</$link></dd>
</$list>
</dl>
Don't forget about the concept of [[vocabTerm]] ({{vocabTerm!!summary}}) it is very relevant to the current topic of discussion...

The text field can then be used to hold additional information, examples of the term in use, or any other related info: including transclusions of its own summary field and any other tiddlers.

1 Like

If you’re trying to produce documents that will later be shared with others, either you will look like one of those crazed internet conspiracy theorists who coincidentally never learned to spell, or you will have to take the time to go through the doc and meticulously fix everything.

Yes, it seemed like a really cool idea in 1996. But it turned out to cause more problems than it solved. With TW, it’s better to create the link in situ and then go back and populate the new tiddler later.