search

TiddlyWiki / TiddlyWiki5

A self-contained JavaScript wiki for the browser, Node.js, AWS Lambda etc.
https://tiddlywiki.com/
Other
7.97k stars 1.18k forks source link

[IDEA] Reformulate default page subtitle and include version number #6873

Open twMat opened 2 years ago

twMat commented 2 years ago

The current default wiki-subtitle states

a non-linear personal web notebook

This is not great. It can be argued if "web" is at all true and I'm not sure the non-linearity is very unique in software notebooks anymore even if TW might take it further than most. And the term "notebook" implies a rather narrow use case.

Actually, I'm even pretty sure Jeremy mentioned that this subtitle was more or less intended as a joke originally. TW is just way too sophisticated now to not take this more seriously so I would like to rephrase it. IMO the following captures the essence better:

a personal wiki system

...further...

In #6870 @amreus writes:

[...] it would be handy to see the <<version>> somewhere on a new wiki.

I agree with this, in spite of the version number appearing in Ctrlpanel > Info > Basics and in sidebar > Tools tab and, of course, in the core plugin info. It is still a bit too "missable" and encouraging people to keep their wiki upgraded is just a generally good idea.

Proposal

Include the version as a part of the default page subtitle. That will make it unmissable yet simple to remove if you don't want it there. And it educates the user in the process, by exposing the <<version>> macro call. This could even very well be the first explicit exposure to a macro call that a uses sees and it is a very "appropriate" and self explanatory one.

Thus, my full proposal for a reformulated page subtitle would be

a personal wiki system | v. 5.2.3

amreus commented 2 years ago

Right I do typically put <<version>> in the SiteSubTitle anyway for the reasons @twMat stated. I'm not sure if it will increase the discoverability of macros/variables but it does tell me without further thought or effort if I should upgrade, or which version of the documentation I need to be referencing.

amreus commented 2 years ago

I wrote:

I'm not sure if it will increase the discoverability of macros/variables

Actually wrote the opposite of what I wanted - I meant seeing <<version>> in the input field will likely help with understanding and discoverability.