Loading...
 
Skip to main content

Custom Share Module 0.1dev

Documentation

Documentation


Installation on Ubuntu

posts: 5 Australia

Hi

I've tried installing on an Ubuntu machine to test and have found the guidance to be not very helpful.

The documentation here https://doc.tiki.org/Installation assumes that all prerequisites are in place, whereas the documentation here https://doc.tiki.org/Ubuntu-Install assumes that you have nothing installed.

Delving further into the Ubuntu documentation, rather than being written from the expectation that as of the day of writing, the end user would be expecting to install the latest version of TikiWiki (ie 27), it instead assumes that a user of Ubuntu 22.04 wants to downgrade PHP back to version 7.4 from the default install of 8.1 in order to install a prior version of TikiWiki.

It is not clear where the PHP7.4 diversion ends as there are a number of elements required to be added.

The installation instructions then go into Apache but omit the requirement for the ServerName to be set in the directives.

At this point https://doc.tiki.org/Ubuntu-Install#Install_Tiki_24_through_git the assumption is that the end user installs v24 which has been superseded by v27 which has a different and easier method of installation (just following the instructions for 24 and changing "24" to "27" isn't a great experience as v27 has the setup.sh option of "b" that does a lot of the stuff that was previously done manually).

This linear document format is not really a very clear way to provide an end user with the information that they need.

I would suggest that the installation guide be in the format of

  • Requirements a, b, c,
    • How to install requirements a
    • How to install requirements b
    • How to install requirements c
  • Setting up the database
  • Install v27
  • Other installations
    • How to install v26
    • How to install v24


The expectation is that a linear document has all of the instructions from start to finish and the internet assumption that the document is the most up to date available, so if you come across the instructions for a prior version then that is because the documentation was last updated for that version.

There are no comments at this time.