Since I was critized for editing an existing Tiki theme to fit my needs on two installations, I wanted to give the "official" way a try.
So I visited
https://themes.tiki.org/Creating-a-Tiki-theme
which is the official documentation. I have the impression (but cannot prove this, of course) that I am the first to actually use this...
It fails. On step 1 (Three Ways to Make a New Theme).
https://themes.tiki.org/Three-Ways-to-Make-a-New-Theme
Btw, BOTH pages are dated 2016... There are three alternatives listed:
Less...
There is another documentation from Tiki:
https://themes.tiki.org/Updating-a-Tiki-theme-from-Bootstrap-3-to-4
to which I was pointed recently. Besides the fact that it hasn't been updated in 4 years, it stil reads als "work in progress". Like this table:
Less function | SCSS equivalent |
coming soon | coming soon |
"coming soon". How "soon" is 4 years? Another example
"I'll add a table here of the changes I've had to make when updating Tiki themes, but in the meantime" So we do not learn what changes had to be made, and we cannot learn from Tiki's devs what pitfalls were discovered. And there the documentation ends...
Bootstrap's documentation, on the other hand
https://getbootstrap.com/docs/4.0/migration/
isn't very useful as well. It addresses only developers who are fully rooted in the entire Bootstrap universe. Frankly, I understand not even half of the stuff.
To help developers solve the bug, we kindly request that you demonstrate your bug on a show2.tiki.org instance. To start, simply select a version and click on "Create show2.tiki.org instance". Once the instance is ready (in a minute or two), as indicated in the status window below, you can then access that instance, login (the initial admin username/password is "admin") and configure the Tiki to demonstrate your bug. Priority will be given to bugs that have been demonstrated on show2.tiki.org.