How to manage community editions

Note This thread was split from the announcement of Tidbits. That one serves as the showcase for and discussion of the recipe edition. This one is about community editions more generally.

Everyone in here talking about their cooking UX, meanwhile I’m interested in the community edition framework/ecosystem. :grin:

Some questions… Is the community getting onboard? Anyone planning to launch a new edition? How is the collaboration going to work? Make a big PR for @Scott_Sauyet to consider? Or make an edition proposal first somewhere/somehow? What would be the criteria for acceptance or rejection? Who will decide? Is @Scott_Sauyet the benevolent dicator for life (BDFL) of the TW5-CommunityEditions?

We all know there are lots of potential “editions” out there. Any current or prospective edition maintainer interested in migrating to, or at least making an edition available at TW5-CommunityEditions?

FWIW I’d love to see a tested and bug-free Todo list/Projectify edition.

Wdyt?

@simon

Ps, I could make my MPTW edition available in TW5-CommunityEditions. It’s a bit light on functionality though. Would it meet the criteria for inclusion?

Pps, this might be better moved to a fresh topic to keep it distinct from the Tidbits bugs conversation!

Great. Because that was the larger goal. Recipes was just a demonstration of the idea. Albeit a demonstration that took about three times as long as expected!

There was a lot of interested talk about this in the threads mentioned in the first paragraph of the OP:

But there were no real decisions. I’ve been putting off working on a recipe edition for far too long. In coming back to it, I thought I could use it to put up a target for discussion on the whole idea. But I jumped the gun on an announcement when I was finally fairly satisfied with this edition itself. I really would like to have at least two more sample editions before I try to come up with another target: a community editions platform of some sort.

I have a number of vague ideas about it, and I don’t mind being the one to put in a stake in the ground. It’s so much easier to have these discussions when they sound more like, “Why don’t we do this instead of that?” than like, “Well, we could try any of these options.” When this approach is done well, the final product could end up entirely unlike or nearly identical to the original approach, but everyone has been able to have their say.

I would hope that it would happen here in Talk, maybe with a dedicated channel.

Good questions! Next, question, please? :wink:

I’m thinking of discussions here in Talk, ideally using some Discourse voting mechanism. A discussion goes on for a while, and someone says “Call the question”, and we post a poll here. If we get at least n votes, with at least p percent voting yes, the edition / change/ whatever is accepted. For instance, @SnapSam asks about a potential new edition. Discussion ensues. Changes are proposed, some are accepted by Sam, some rejected, changes are made, and as new suggestions seem to peter out, @Springer says, “Call the question”, and @Thomas_Chuffart, @vilc, @TiddlyTitch , and I and ten more people all like @Springer’s post, enough to end the debate. And you, @simon, or one of the other Editions moderators – what, weren’t you volunteering to be a moderator, Simon? Sorry you’ve been drafted – you post a poll and a week later we check it for the thresholds. Enough voters? Check! A high enough percent of “yes” votes? Check! The edition is chosen for inclusion, and added to our fancy-dancy new tool.

Agreed. I was thinking of TODO as a likely candidate for an edition. I have used Projectify, but as with any such tools, I seem to have abandoned it after a short period. :frowning: I think we’d need to have its creator or a regular user work on such an edition.

No.

God, no!

I needed a break from this work, but expect to get back to it in the next few days. My goal was to do much simpler proofs of concept for two other editions; I didn’t know what editions yet. And then I thought there would be just barely enough content to hang our discussion on.

I would like to stay involved, and if we have some Community Editions moderators, I would be happy to serve as one of them.

But, while I’m reasonably good at building things, I’m not so great at maintaining them!

I don’t know. How well does it meet the Criteria? :slight_smile:

A community edition:

  1. must serve a useful and relatively common purpose.
  2. should have a clear, narrow scope and a complexity ceiling — roughly 1,000 words of explanation should suffice to understand the whole thing.
  3. should work out of the box without configuration.
  4. should be self-documenting from within.
  5. should ship with illustrative sample content — ideally as a separate JSON bundle so the empty and populated artifacts are both first-class.
  6. should make common customizations easy — palette-based theming, user-facing strings in well-named tiddlers, no hardcoded UI strings or colors.
  7. should showcase idiomatic, modern TiddlyWiki — educational as well as functional; modern techniques preferred but not pushed.
  8. should be maintainable — prefer core TW and established community plugins over custom wikitext.
  9. should follow TW namespace conventions — keep implementation details someplace like $:/community/recipes/....
  10. should be deployment-agnostic — single-file HTML, but nothing that breaks under Node or a server.

Or what should we be looking to relax or tighten up in this criteria?

I fhink you’ve done an amazing job with this so far, and I think its a great step forward on making Tiddlywiki more accessible to new users as a whole. :grin:

as far as critique, Id want to touch on the skill ceilong part you pointed out.

rather than limiting it, we could give them ratings of complexity? something like how biking paths are with beginner intermediate advanced etc.

Just food for thought (and yes, that is a pun because of your recipe edition)

Thank you. That is the entire goal. I’m glad to hear this seems to be headed in the right direction.

Maybe. Perhaps eventually. The thrust of the motivating threads for this, though, was to make it easier for beginners to understand and appreciate TiddlyWiki. My thought was that an approach to Community Editions needs to stress simplicity.

Clearly, editions in general can have whatever level of complexity they need to serve their purpose.

I did soften https://github.com/CrossEye/TW5-CommunityEditions/blob/main/Philosophy/EditionCriteria.md to replace “An edition must…” with “A community edition must”, and I will edit the OP to that end too.

I’ll let it marinate. :wink:

This is great!

I’d love to publish this (as well future community editions) as a template on Tiddlyhost. If I pull down from Tidbits — Community Recipe Edition v1.0.1 is that going to be always a freshly built latest version?

I could do my own build if needed, but a simple curl fetch would be convenient.

I think that would be great!

I’m hoping that eventually the URL will change, but it should always be a simple fetch.

I didn’t talk about it much in the OP, but this was supposed to be Stage 1 of a multi-stage process. However, it’s consumed all my free time (and too much of my sleep time as well) for a few weeks, and outside my small roadmap and the feedback I get here, I probably will sit on it for a little while. Especially as local politics is going to capture a lot of my free time for the next few weeks.

However the plan was (and still is, even if delayed) that Stages 2 and 3 were to try to build sample editions for two other familiar domains. And with a few at hand, Stage 4 was to build a UI to manage community editions. At that point, I would expect the URL to change. Ideally, I would love it to be something like editions.tiddlywiki.com, pointing to a Docker container running somewhere. A small Stage 5 would be to introduce this to the TiddlyWiki front page, so that first-time users can try working with TW with something relevant to their needs. I hope after a short hiatus, I can return to these goals.

Something like this is what I was thinking:

https://tiddlyhost.com/explore/user/tw5-ce

At the moment it’s updated manually, but if the Community Editions repo takes off we might want to create some automation to make sure it’s always fresh.

(To see how the sausage is made, look here.)

That makes perfect sense to me, but I’m hoping for another mechanism as well, as discussed.

Got it. Another food reference in relation to this project, huh?!