This should attract more users!

I’ll need to figure out how to use it. I’ve only taken the tour so far :grin:

7 posts were split to a new topic: Mixed thoughts on how to improve stuff for users

I think there are many edition that is as friendly as TidGi (some user say TidGi lacks help gguide, so other edition may be more friendly than TidGi)

So I think here we need an edition generator. I’m consider making TidGi desktop to be a template repo, so everyone can use it to generate their own release of desktop app. That bring useful plugins and Notion-level UI, and most importantly can save to a folder on the disk without further configuration.

I recently eat Subway (sandwich) everyday.

Their app provides ingredients, but most people (even geek like me) will pick a preset with drink.

I think the ordering flow and UI design can be referenced.

1 Like

I completely concur that a handful of well thought out, documented and maintained editions would make an excellent starting point for new users. However, the real issue at present isn’t how to draw attention to editions or how to present them at tiddlywiki-com, but rather the scarcity of well designed and maintained editions to draw attention to.

Creating an edition is a significant amount of work upfront and also requires a commitment to provide support and maintenance afterwards. As a community, it might be time to explore options for supporting and incentivizing such ongoing work, perhaps through Open Collective.

Efforts to create and maintain editions that don’t intersect with one’s personal interests seem unlikely to be sustained over time. I personally maintain two very niche editions for a small group of users, and the key to maintaining my interest has been that I personally use these editions on a very regular basis.

Can we think of any editions that exist at present that are well designed, documented and maintained?

While I certainly support the idea to incentivize such work, the question is not a binary between “well designed and maintaned editions” vs not fully so. It can be both because what is the goal here? It is to convert more of the tw.‍com visitors into users than what the site currently does!

To convert more visitors, I’d say that some merely decent demos would suffice - if the visitors are actually exposed to them. Of course, it would be even better if editions were more than just good enough. But “merely decent” editions would be a very good start.

If they are not up-to-date already after a year? Well, then they have converted visitors for a full year - yay! Besides, nothing is set in stone; if better starter-editions were to come up, they could just replace less polished/maintained ones.

I dare even say that the high standards typically held for tw.‍com and TW stuff, is a major reason why we don’t already have any real such editions. I can point to a dozen people here that have both enough know-how and willingness to create, or at least contribute to, decent enough “editions” for the above defined goal. I, myself, am certainly one of them. In terms of skills and quality, I’m no Jeremy/Saq/Mario/… but I’m 99% certain that I could excite visitors enough to convert more of them than what currently happens (the last percent is merely for modesty :wink: ) But there are many reasons why I don’t, including, at this moment, 202 reasons over at github.

…and, in that vein, before spending much time on this matter, I would need to know more what @jeremyruston actually thinks about this all, more than the brief comment above. It is a total waste of effort if Jeremy, being the sole gatekeeper, doesn’t approve of it in the first place.

I think there is a point to distinguish between demos (be they designed as actual demos or be they real-use wikis) - vs “starter editions” that I’d say would be more about something that visitors can “try out” and download to start to use for their own data. There is definitely a demo element to such a “starter edition”, but my point is that it would not make sense for anyone to currently have what you request because why would they?

1 Like

@twMat you alluded specifically to editions that can be an alternative to the empty edition in your original post. So which is it? Demos that serve as an example of possible functionality, or editions that are preconfigured for specific use cases? The difference is important especially if the intent is to make them directly downloadable alongside the empty edition, as you suggested. Otherwise you are conflating two things that really need to be considered separately in terms of how they are presented.

Furthermore, as regarding demos, I am quite skeptical as to how useful that we could be in driving adoption, most users that do not want to learn the intricacies of wikitext want something that works reasonably well out of the box. Alternatively if we do want to make it easier to get started with building functionality with wikitext, a step by step guide to building a set of features as described by @stobot would likely be more useful.

Can you point to any examples of editions, or guides or tutorials or demos, that were suggested for listing on tw-com and rejected?

We already have a Community Editions tiddler and an argument can be made for making the editions listed there more prominent. One could even imagine linking to a dedicated editions.tiddlywiki.org site.

However, I see nothing at present that prevents any community member from creating an edition and asking to have it listed there. In fact I see editions listed there now that were created by far less experienced wikitext coders than most of the regulars here and that have plenty of cruft under the covers, but provide a useful experience regardless and are thus rightfully listed there.

1 Like

Good you’re pointing out my inconsistencies! There are indeed two parallel concepts in my mind; one is a direct download button, only showing the “name” of the edition or perhaps a “card” with a very brief explanation, compare to the current cards in HelloThere. Basically what @Scott_Sauyet sketched here above.

…and the other has similar looking buttons but that instead open an InnerWiki or similar to basically show what they will get if they click the download button which is now also seen. Here’s an (inofficial) mockup of this.

What would be the correct term for this set-up:

  • based on an empty edition
  • plus a few installed plugins
  • a few native settings have been changed
  • some dummy sample tiddlers that are not part of a plugin (e.g some groceries for a “Grocery edition”)
  • an “About” type tiddler with some introductory/explanatory notes about the specific setup
  • a tiddler listing all “deviations” from the empty edition (including e.g a “delete all dummytiddlers” button and similar)

The users first step towards an informed go-or-dismiss decision is the very name on “the button” on tw.‍com (i.e “Geneaology edition”, “Grocery shopping edition”, …) and when they actually see it, they see whatever the edition-constructor decided was appopriate to show. The content/layout/setup/UX/… may vary greatly depending on target group, this is up to the expertise of the constructor. But it probably shows a few of the above listed bits. Hopefully this convinces the visitor to click download, if it wasn’t already the downloaded he/she fiddled with. If there is a quick demo in an innerwiki, it may differ a tad from what is downloaded, e.g default-tiddlers, but I’d guess it is mostly the same.

What would be an appropriate term for this/these?

Oh, I fully agree! The edition constructors should set-up the wikis to be as turn-key as possible. And they, in a role of experts, know best what the target group wants. I couldn’t make a decent soccer edition even if I wanted to.

IMO this is looking at it from the wrong direction. The fact that there are only 8 editions there, after all these years, several of which I’d think come from Jeremy, is a very clear indication that something is not encouraging people to contribute editions - in spite of there being quite a few “sharers” among us.

We already have a Community Editions tiddler and an argument can be made for making the editions listed there more prominent.

Sure. But “prominent ≠ shown”.

However, I see nothing at present that prevents any community member from creating an edition and asking to have it listed there.

So, what is your guess as to why this basically doesn’t happen?

1 Like

Your focus in this thread would seem to imply that the lack of prominent mention on tw-com is the reason for the scarcity of community editions. I would be very surprised if this was indeed the case.

The significant investment of time and effort required to create and maintain something reusable for others as opposed to specific to ones own specific circumstances, along with the knowledge and expertise of both wikitext and also of the domain in question.

Again, thanks for your valuable points.

The significant investment of time and effort required to create and maintain something reusable for others

What if someone, somehow, manages to produce editions that succeed in adpoting users (more than it scares away) - but the editions were not quite as burdensome to create as you describe? Would you agree that they are still worth featuring on tw-com? Is there, for example, anything problematic in the rough bullet list I posted above (which more or less only talks about content)? And is there a minimum “duration” that editions must last in your opinion (ref maintainence)?

In principle, not at all, though it really would depend on the utility offered by any such edition.

If the intent is to offer the editions for download alongside empty.html then the minimum requirement for maintenance would be:

  • the edition should be on the current version of TiddlyWiki, which implies keeping it updated at pace with core releases.
  • any serious flaws identified by users should be addressed in a timely manner
  • any problems with the documentation that make it difficult to understand the intent, workflow and utility offered by the edition are addressed in a timely manner.
  • hosted on tw-com

On the other hand, if we only want to present these editions as examples of what is possible, then the requirements for maintenance can be significantly relaxed.

I feel like this should be a neccesary point to discuss: we should also talk about the archiving and versioning of these editions.

One of the main reoccurring issues I’ve seen is that, due to each edition being an indepentent project, they are left under the care of their creators to keep maintained and available.

In the event that the site hosting that edition is terminated then… now you have a dead link on the homepage of our wonder tool :thinking:

I propose whenever someone wants to introduce a new community edition, it should be put to a poll here, and if it is approved, a copy should be downloaded and kept in a github page, maybe under the same one as the core tiddlywiki5 github, but as a branch(I may be referring to that incorrectly? I don’t use github, I wish I knew more about it.) that way, updates can still be pushed to it, but in the event the creator goes dark, it remains available to the community.

It would also mean that by adopting it as a community edition, the creator would have to agree to it receiving the same copyright terms as the vanilla edition, free to use, modify, etc.

Just thought this was something worth bringing up :sweat_smile:

See some of the previous discussions in Community curated editions - How best to coordinate our efforts? and others linked at the top of its first post.

We probably shouldn’t spend more thinking on this before Jeremy clarifies how he sees the ideas thus far…

…but…

I think it would be much better with “minimal admin” like so: Be less restrictive and demanding what is put up, but be firm on what is taken away! The nature of this project is that people abandon projects - let’s accept this. We could automate to see if links are actually dead and they are removed, and I think we can rely on members reporting when some edition is outdated and it is also removed.

…or it can simply be demoted to the tiddler “Community Editions” (one of the tiddlers that you, like the resto of us, had no idea existed even if it sits in one of the default tiddlers).

The nature of the TW project is that both people and things come and go and change. If anything, the tw-com site would do well some more frequent changes. Imagine if the editions had small but nice cards (even just gradients). A little rearrangement among them from removing an outdated edition-button or two might even be visually positive.

If the owner updates the edtion well, then it might appear again. Also that can perhaps be automated.

I wonder if we shouldn’t do this stand-alone first… with the goal of folding it back into the main page, but only once the kinks are worked out.

4 Likes

when reading through this thread i had the same thought.
each core version update would require updating the list of editions to ensure they are updated, and right after a core release it is likely that many will not be updated yet so that section would be pretty empty.

who is responsible for monitoring the status of editions submitted and making sure the website is up to date with releases (hopefully not Jeremy)? who compiles the running list of submitted editions and determines which are high-quality enough for their use case to be presented so prominently on the front page of the platform? a flimsy edition, or lack of suitable editions, would make a bad first impression for new users i feel :confused:

I think an issue would be a “lack of maintainers” as TW5 evolves though rare some custom editions may break. Having someone who can watch versions outside of Core and official plugins would very soon become taxing as it Essentially unpaid. The issue with “tiddlywiki” not being in someone’s “use case” seems kinda absurd, much like “linux doesn’t do X thing” generally speaking if one of the 1,000+ plugins doesn’t itch your scratch then it’s hard to blame tiddlywiki for not fitting such a niche use case. In honesty “Editions” should be “Demos” examples of what Tiddlywiki CAN do, but tiddlywiki is sorta an extendable framework, you run into the issue Linux has where there’s 866 distros, and my x distro doesn’t work well for x thing. Tiddlywiki has so many dynamic elements that at best a community editions store (tiddlyhost) is good but the issue falls back to people willing to maintain their code. Maintaining software is hard, and the core team can’t really know that x patch won’t break a small feature that existed in v5.1.1 that x Edition needs. Tiddlywiki is relatively stable compared to virtually anything like it (even Linux honesty). I think Having a community editions/macros/plugin repo would be cool but the community has to do it much like CPL. That’s my 2 cents atleast.

First off, that concern is a quite ironic for a piece of software that, possibly more than any other software out there, focuses on “backward compatibility” and “use it in 25 years”. Why would it be bad to show something from a few editions back? Why? Is the current version a “bad impression” in a year?

Sure, it would be even better if such editions were updated even daily - but you must look at the proposal in its context instead: We have indications that the current presentation of TW is just not very good because TW belongs to a very popular type of software - and yet it is itself not very popular! You tell me; why should visitors NOT turn on their heels coming there, when they don’t quite understand how TW can solve their needs? I can think of no better way to help them make an informed decision to go/nogo with TW than the outlined proposal.

I think we flatter ourselves expecting the users to be as excited as we are but, to them, TW is no more interesting than anything else. Probably even the opposite; “Marketing” is about creating interest. But all the visitors see of TW is tiddlywiki.‍com which, as far as I can tell, is a site that breaks all rules for marketing; waaay too much text, very messy, unfamiliar interface, and a potpurri of arbitrary words/links/items/images that overloads your working memory!

So stop worrying about if the editions would be perfect; the tw-com site needs a change. We don’t know what exactly would work, but the OP is probably one of the simplest and best ideas I’ve seen in several years. Yes, obviously I’m biased, but do tell me any better idea that is doable and also consider the premise: prolly ain’t nobody getting paid!

Again, the goal here is to convert more visitors into users by helping them make an informed decision whether TW will help with their needs.

3 Likes

Maybe a selling point could be an ease of use case similar to that of say tiddlyhost, I think a primary bar to entry is either having to run a manual clunky save, or node.js or browser plugin, etc. With something like notion it’s ready to go and supports simple features like push notifications. I can’t visualize personally what would make TW “Look” more appealing (Probably because I’m biased). I do think that one major issue I’ve seen is it’s hard for me to give a “Simple” explanation on TW, I have Probably scared off a few potential users trying to convince them because I tell them of the infinite potential. Basic users want something cut and dry I think. I do like the idea of a more average user layout. Something that an average user can see and think “yeah I can do that”. The slideshow is a great start I think. It can feel overwhelming looking at tw5 and knowing where to start can be hard. What would be a good way to display tiddlywiki while staying true?

Tangentially, I thought I’d convinced ChatGPT (4o mini) today that TiddlyWiki could be considered a JavaScript framework, but then it tacked this on the end:

However, while TiddlyWiki’s flexibility allows it to function in ways comparable to a framework, it remains primarily a specialized application with its own design and purpose. The distinction often lies in its primary intent and how it is utilized—whether as a standalone application or as a foundational tool for creating other applications.

Maybe if I log in, the bigger “smarter” model will agree with me. :joy: