58388[TASK] Update INSTALL.md and README.md
Commit message
Review
-
Code review CR +2
- Susi Moog +2
- Benni Mack +1
-
Verified V +2
- Susi Moog +2
- Benni Mack +1
- TYPO3com +1 CI
Issues 1
Files 2
Review log 3946
Show 2021 earlier messages
-
Josef Glatz uploaded patch set 1 09/25/18, 11:57
-
Josef Glatz commented on patch set 1 09/25/18, 11:59
Hey folks! i would like to get some first feedback on my draft if I should continue my work AND open to any suggestions what should be fundamentally changed in the two files -
Josef Glatz wrote 09/25/18, 12:00
Topic set to readme -
Josef Glatz commented on patch set 1 09/25/18, 12:24
INSTALL.md:23Should we add minimum version numbers for Chrome, Firefox and Safari?INSTALL.md:24Should we mention, that the main goal is to make the TYPO3 backend working even in "older" browers and it's ok if some styling is not 100% good.INSTALL.md:41Re-think disk space specification (Core needs about ~200MB on disk without exts and without DB). Do we still need that info? Should we mention something like "200MB for a running TYPO3 instance + user assets/files + database + extensions + and other additional code?INSTALL.md:42why do we not only suggest GM?INSTALL.md:54Should we split up DBMS specific requirements completeley into segments?INSTALL.md:57Should we rewrite this part to a generic form? If yes: I don't have knowledge of sqlite, ... I would need some help here from the db pro'sINSTALL.md:59Can I simply use "database user" instead of "MySQL user"?INSTALL.md:106I think we should definitely add dedicated documentation to docs.typo3.org and link them here. Such an enterprise cms needs such docu.INSTALL.md:112Do we need something else for the core url handling stuff?INSTALL.md:114Is it ok to mention MariaDB for the "best performance" scenario?INSTALL.md:119another version than 7.2 is not officially tested. Let's updated this, whenever the core supports 7.3. It's just not good to say something which we can not promiseINSTALL.md:127This points must be updated in context of the related PHP version 7.2. Do I miss something here?INSTALL.md:134Do I miss any other optional extension to support another supported dbms?INSTALL.md:219When do we ship nginx ready configurations for TYPO3 ? are there any plans? earlybird.at says they using nginx without problems..INSTALL.md:329Is this bulletpoint valid? Should I rephrase it?INSTALL.md:358Should we drop that, as TYPO3 is compatible with strict-mode of MySQLREADME.md:14I think mentioning MySQL is nowadays still the best possibility here)README.md:25Should we add any other often used webserver which I forgot?README.md:30Is that correct?README.md:53Should we add/remove here any DBMS?README.md:68I removed wiki.typo3.or as it will be removed in "near" futureREADME.md:84I think it's good to directly mention the TER to get an overview of available 3rd party exts in the TYPO3 universe (beside packagist)README.md:117I think it's OK to mention that there is not so much trafficREADME.md:119Added the new url. Should we add a shorturl at t3o?README.md:121Should we mention the actual ways of where to host extensions nowadays?README.md:133Maybe this text could be improved. I think also about a special channel on slack, where people can ask for such stuff?README.md:158I think this is something which could be removed as it doesn't help anybody. Mostly newcomers read those documents - so it make no sense to me. But yes, we could leave that. -
Josef Glatz updated the commit message in patch set 2 09/25/18, 12:25
-
Josef Glatz wrote 09/25/18, 12:41
Removed reviewer Susi Moog. -
Sybille Peters commented on patch set 2 09/25/18, 13:55
I added some comments. Additionally, I think installation via composer is neglected in the INSTALL.md. Also, it might be a good idea to add extra links at the bottom to additional information like the requirements page (https://typo3.org/cms/requirements/) and to the installation & upgrade guide (https://docs.typo3.org/typo3cms/InstallationGuide/), which probably should be reviewed as well.INSTALL.md:43The sentence about MariaDB and Percona was removed here. In the list above, only MariaDB was mentioned, not Percona. I assume Percona is still supported. Maybe better to mention in the list above: any MySQL compatible DB engine like MariaDB or Percona? Or "or any database system supported by Doctrine DBAL" as mentioned in https://typo3.org/cms/requirements/INSTALL.md:72According to the core install/Classes/SystemEnvironment/Check.php recommended memory_limit is 128M.INSTALL.md:111I believe you also need mod_rewrite if you don't use realurl.INSTALL.md:114You write MySQL 5.5 here, but >= 5 above.INSTALL.md:119You write 7.2 here, but >= 7.2 above.INSTALL.md:125You might want to just check if OPCache is enabled by default: opcache.enable=1, http://php.net/manual/en/opcache.configuration.phpINSTALL.md:140"throws out warnings" sounds weird. Better: "throws exceptions" or " causes warnings" -
Susi Moog commented on patch set 2 09/25/18, 18:38
INSTALL.md:49Add sentence about _web.config example file for IIS?INSTALL.md:54InnoDB is only relevant to some databases (mysql and mariadb?).INSTALL.md:59rewrite to generic user rights instead of mysql specificINSTALL.md:72Replyminimum is 64, recommended is 128, maybe add both?INSTALL.md:74Qualify to: when using Apache:INSTALL.md:99these need updates, too. Mysqli --> only when using mysql obviously. as for the others: are there version without "SPL/standard"? core composer json states the following as required: "ext-PDO": "*", "ext-json": "*", "ext-pcre": "*", "ext-session": "*", "ext-xml": "*", and these as suggestion: "ext-gd" "ext-fileinfo "ext-zlib" "ext-intl" "ext-openssl" "ext-zip"INSTALL.md:111Reply- in v9 with url routing you at least need it if you have a site config - I'm not sure we should still recommend Apache as "best" setupINSTALL.md:125ReplyI would not recommend adding another opcache on top of PHPs default one.INSTALL.md:151we should add something about a composer based setup (which I'd consider recommended) somewhere.INSTALL.md:242areREADME.md:117I'd actually remove the mention of these two.README.md:131#typo3-cms-coredevREADME.md:133get you up and running? -
Susi Moog commented on patch set 2 09/25/18, 18:48
INSTALL.md:23ReplyI wouldn't, we'd only forget to update these and basically we communicate "latest"INSTALL.md:24Replyhmm, basically the goal is to have a browser everyone can have, but for everything except IE11 I'd rather promote updating (on IE11 that may sometimes be impossible)INSTALL.md:41ReplyCore with tests or package? I'd add something sensible / recommended here, for people looking for hosting providers etc.INSTALL.md:42ReplyBecause these are `requirements` not only recommendations and if people have a server with IM they should still know that they'll be able to use that.INSTALL.md:59ReplyI think so (for the other part, see my comment on patch set 2)INSTALL.md:106Replyyes and stop linking to the wiki with random untested hints from people for topics such as performance ;)INSTALL.md:112Replynope, mod_rewrite / url rewriting it isINSTALL.md:114Replyfor the best performance scenario I'm not even sure if that wouldn't be postgres or something, I'd rather correct the sentence above to: this is a basic recommended setup: (and leave the performance part out of it, as that largely depends on other factors, especially since we are using doctrine now - and neither mysql nor mariadb are especially known for high-performance in comparison).INSTALL.md:134ReplyI'm using extension=pdo_sqlsrv for sqlsrv instead of sqlsrv itself, not sure if that's relevant.INSTALL.md:219Replysee https://forge.typo3.org/issues/54316 - whenever that one is tackled. the problem is in comparison with apache and IIS we cannot provide a file that you can simply rename in the project dir and be ready, it would just be an example config people need to add to their server setup.INSTALL.md:329ReplyProbably, for example it would be a good idea to make the whole core non-writable.INSTALL.md:358Replyyes. -
Daniel Siepmann commented on patch set 2 09/26/18, 05:54
We could switch to rst and make use of `.. contents:: :local:` this way we can have a table of contents listing out of the box, e.g. at Github. For an example you can check https://github.com/DanielSiepmann/testing-talk/blob/a507875/readme.rst -
Josef Glatz commented on patch set 2 09/26/18, 06:02
Thanks for your replies! Many thanks! I push a new one with all your inputs during the day -
Daniel Siepmann commented on patch set 2 09/26/18, 06:13
INSTALL.md:23Apple renamed MacOS X to "macOS"INSTALL.md:41This depends on the type of installation. If you are using composer, only required system extensions are installed, which can result in smaller installations. Also I didn't check the actual installation size with all necessary dependencies.INSTALL.md:73As some Unix Distrbutions deliver their own defaults, not all might have a appropriate xdebug.max_nesting_level value. Do we want to give a hint for development environments with xdebug?INSTALL.md:114ReplyThis is the recommended setup, above was the minimum required setup. So this might be correct.INSTALL.md:116This is now already in the reuired setup and can be removed here.INSTALL.md:119ReplyProbably this can just be removed here.INSTALL.md:125ReplySome Unix distributions come with their own defaults. So PHP defaults are not necessary the defaults for installed PHP versions.README.md:26Apple renamed MacOS X to "macOS"README.md:47I would not list the information twice. I would keep a link to the INSTALL.md instead. Otherwise we have multiple places and need to update all of them in the future. -
Susi Moog commented on patch set 2 09/26/18, 07:51
INSTALL.md:125ReplyMy point was more, do not promote zend optimizer or wincache on top of PHPs internal OpCache (nothing really todo with distribution defaults, but with the fact that PHP Core has an opcache already) -
Josef Glatz uploaded patch set 3 09/30/18, 19:53
-
Josef Glatz commented on patch set 2 09/30/18, 19:53
INSTALL.md:23ReplyDoneINSTALL.md:49ReplyDoneINSTALL.md:54ReplyDoneINSTALL.md:59ReplyDoneINSTALL.md:72ReplyDoneINSTALL.md:72Reply UnresolvedDoneINSTALL.md:73ReplyI would add that to the contribution workflow AND/OR install documentation on docs.typo3.orgINSTALL.md:74ReplyDoneINSTALL.md:99ReplyDone -
TYPO3com voted on patch set 3 V +1 09/30/18, 20:28 Completed build in 23m 08s on Sun, 30 Sep, 10:28 PM Test Summary: 36913 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29080
-
Josef Glatz uploaded patch set 4 09/30/18, 20:59
-
Josef Glatz commented on patch set 2 09/30/18, 21:00
INSTALL.md:41ReplyThx! As a first step I've add info that it depends on the install methodINSTALL.md:73ReplyDoneINSTALL.md:74ReplyDoneINSTALL.md:111ReplyI have moved mod_rewrite to the basic requirements with an hint as this is something almost every TYPO3 website uses.INSTALL.md:111Reply UnresolvedDoneINSTALL.md:114ReplyDoneINSTALL.md:114Reply Unresolved5.5 is already correct (\TYPO3\CMS\Install\SystemEnvironment\DatabasePlatform\MySqlCheck::$minimumMySQLVersion)INSTALL.md:119ReplyDoneINSTALL.md:119Reply UnresolvedDoneINSTALL.md:125ReplyDoneINSTALL.md:125ReplyDoneINSTALL.md:125ReplyDoneINSTALL.md:125Reply UnresolvedDo you want to mention something like: "(make sure opcache is enabled in php.ini)"INSTALL.md:140Reply UnresolvedDoneINSTALL.md:242ReplyDone -
Josef Glatz commented on patch set 2 09/30/18, 21:09
README.md:26ReplyDoneREADME.md:47ReplyDoneREADME.md:117ReplyDoneREADME.md:131ReplyThis is the anchor link to the header Chat with us ;) I've added additional info to it, thx!README.md:133Replyadded your text. please recheck in my upcoming patchset. thx susi! -
Josef Glatz uploaded patch set 5 09/30/18, 21:11
-
Josef Glatz uploaded patch set 6 09/30/18, 21:22
-
Josef Glatz commented on patch set 2 09/30/18, 21:24
INSTALL.md:43Reply UnresolvedEagle Eye!! ツ At the moment, PerconaDB isn't supported officially as far as I can see. Even not all Doctrine DBAL supported DBMS's aren't support AFAIK. But I will kindly ask Benni/Susi to take that into account while proof reading -
TYPO3com voted on patch set 4 V +1 09/30/18, 21:36 Completed build in 28m 20s on Sun, 30 Sep, 11:36 PM Test Summary: 36913 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29094
-
TYPO3com voted on patch set 5 V +1 09/30/18, 21:45 Completed build in 16m 54s on Sun, 30 Sep, 11:45 PM Test Summary: 36913 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29097
-
TYPO3com voted on patch set 6 V +1 09/30/18, 21:53 Completed build in 25m 39s on Sun, 30 Sep, 11:53 PM Test Summary: 36913 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29098
-
Josef Glatz wrote 10/01/18, 04:28
Assignee added: Benni Mack <benni@typo3.org> -
Josef Glatz wrote 10/01/18, 04:29
Assignee deleted: Benni Mack <benni@typo3.org> -
Stephan Großberndt commented on patch set 6 10/01/18, 05:48
INSTALL.md:38People who don't know MariaDB is a [binary compatible drop in replacement](https://mariadb.com/kb/en/library/mariadb-vs-mysql-compatibility/) the current list of versions makes it look like MariaDB is only supported with 10.2+ while it is since 5.1 Also see https://github.com/TYPO3-infrastructure/get.typo3.org/issues/18#issuecomment-418386482 where this has been discussed. INSTALL.md, https://get.typo3.org/version/9#system-requirements and https://typo3.org/cms/requirements/ need to be updated and synchronized -
Stephan Großberndt commented on patch set 6 10/01/18, 05:56
INSTALL.md:118Since PHP7 it is no longer called mysqli but mysql IIRC - will checkINSTALL.md:236Is this still true? -
Georg Ringer commented on patch set 6 10/01/18, 09:50
can also take care of being in sync with get.typ3.org? thx -
Susi Moog uploaded patch set 7 10/01/18, 17:54
-
Susi Moog uploaded patch set 8 10/01/18, 17:56
-
Susi Moog commented on patch set 8 10/01/18, 17:57
after a short discussion we decided to mainly remove the texts in the install.md. I will update my PR to the install guide to include the missing information there but this way we have a single source of truth. -
TYPO3com voted on patch set 7 V +1 10/01/18, 18:08 Completed build in 13m 49s on Mon, 1 Oct, 08:08 PM Test Summary: 36913 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29213
-
Benni Mack voted on patch set 8 V +1 CR +1 10/01/18, 18:09
-
Josef Glatz commented on patch set 8 10/01/18, 18:09
> Patch Set 8: > > after a short discussion we decided to mainly remove the texts in the install.md. I will update my PR to the install guide to include the missing information there but this way we have a single source of truth. Great decision! -
Josef Glatz voted on patch set 8 CR -1 10/01/18, 18:13
-
TYPO3com voted on patch set 8 V +1 10/01/18, 18:14 Completed build in 16m 35s on Mon, 1 Oct, 08:14 PM Test Summary: 36913 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29215
-
Josef Glatz updated the commit message in patch set 9 10/01/18, 18:15
-
Benni Mack voted on patch set 9 V +1 CR +1 10/01/18, 18:21
-
Susi Moog commented on patch set 9 10/01/18, 18:21
-
TYPO3com voted on patch set 9 V +1 10/01/18, 18:32 Completed build in 12m 39s on Mon, 1 Oct, 08:32 PM Test Summary: 36928 passed Find logs and detail information at https://bamboo.typo3.com/browse/CORE-GTC-29220
-
Susi Moog voted on patch set 9 V +2 CR +2 10/01/18, 18:41
-
Susi Moog merged patch set 10 10/01/18, 18:41
-
Oliver Hader commented on patch set 10 11/21/18, 16:18
Where do I find supported browsers for TYPO3 v9 now? -
Susi Moog commented on patch set 10 11/22/18, 07:49
@Olly browsers count as "system requirements" -> INSTALL.md says: https://get.typo3.org/version/9#system-requirements