[TYPO3-german] 7.6 Install Documentation

Michael Kasten home at m-kasten.de
Wed Jan 27 10:55:36 CET 2016


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hallo Andrea,

> Es spricht nichts dagegen die Install.md irgendwo bei der Install Dokumentation reinzuparsen.
> Aber das reicht nicht aus, da sind beispielsweise keine Screenshots drin.

an der Stelle gehen dann wohl auch die Ansprüche an so eine Anleitung auseinander :)
Aus meiner persönlichen Erfahrung heraus, halte ich nichts von Screenshots weil:

Recht hoher Arbeitsaufwand
Sobald sich etwas in der Darstellung ändert (und das können Kleinigkeiten sein) sind Screenshots
eher verwirrend, dann müssen wieder alle neu erzeugt werden damit das passt.

Wenn das Team für die Dokus also eh schon knappe Ressourcen hat, wäre mir die inhaltliche
Aktualität lieber als Screenshots.

Wie gesagt eine persönliche Sicht der Dinge und mit Sicherheit nicht Allgemeingültig.

Prinzipiell sind ja auch Bilder in md Dateien möglich.

mit besten Grüßen


> 
> LG Andrea
> 
> 
> Am 26.01.2016 um 16:04 schrieb Michael Kasten:
>> Hallo,
>> 
>> naja wie immer sind die Wogen aus der Versionsschlacht der vergangen Jahre noch nicht
>> geglättet, das merkt man nicht nur an der Doku sondern insgesamt beim googlen da muss man
>> eben die Augen offen halten :)
>> 
>> Mal so ein Gedanke:
>> 
>> Was spricht eigentlich gegen die install.md direkt im Core Paket, ich finde das hier viel
>> Verwirrung vermieden werden kann wenn hier zu den jeweiligen Versionen die richte Anleitung
>> direkt "beiliegt"
>> 
>> Ich denke weiterhin das keiner sich ausschließlich mit der Anleitung auseinander setzt,
>> sondern das immer im Kontext der Installation geschieht, es wäre also naheliegend immer auf
>> die jeweilige Install Info Datei im Core Paket zu verweisen?
>> 
>> Denkbar wäre dann auch eine direkte Verwendung dieser Dateien auf docs.typo3.org, pro Version
>> eine Seite anlegen welche dann die Info direkt aus dem Repo parst.
>> 
>> Dann sollte es die Info nur noch an einer Stelle geben und gepflegt werden können (nämlich im
>> Repo und da ist die Versionierung auch gleich geregelt)
>> 
>> nur mal so ein Gedanke
>> 
>> my2cent
>> 
>> 
>> 
>> Am 26.01.2016 um 12:38 schrieb Michael Schams:
>>> On Tue, 2016-01-26 at 11:40 +0100, Andrea Schmuttermair wrote:
>> 
>>> [...]
>>>> es fehlt irgendwie strukturell was, ich kann ja nicht die 6.2er Dokumentation verändern.
>>>> Es gibt nur EINE Install Doku für beide LTS Versionen, da bräuchts irgendwie ein
>>>> Versionsmenü.
>> 
>>> Das gibt es:
>> 
>>> https://docs.typo3.org/typo3cms/InstallationGuide
>> 
>>> In der linken Spalte findest du ganz unten "Related Links" und (ganz klein rechts) "v: 7".
>>> Ein Klick darauf sollte ein Versionsmenue oeffnen, in dem du andere Versionen (z.B. 4.5,
>>> 6.2 und "latest") der Doku oeffnen kannst (sofern vorhanden).
>> 
>>> Eine andere Moeglichkeit ist, die URL direkt einzugeben, zum Beispiel:
>> 
>>> https://docs.typo3.org/typo3cms/InstallationGuide/4.5/ 
>>> https://docs.typo3.org/typo3cms/InstallationGuide/6.1/ 
>>> https://docs.typo3.org/typo3cms/InstallationGuide/latest/
>> 
>>> Das aendert natuerlich nichts an der Tatsache, dass bei der "latest" Version (also momentan
>>> 7 LTS) die Versionsnummern korrigiert werden muessen :-)
>> 
>> 
>>> Cheers Michael
>> 
>> 
>>> _______________________________________________ TYPO3-german mailing list
>>> TYPO3-german at lists.typo3.org http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-german
>> 
>> 
>> _______________________________________________ TYPO3-german mailing list
>> TYPO3-german at lists.typo3.org http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-german
>> 
> _______________________________________________ TYPO3-german mailing list 
> TYPO3-german at lists.typo3.org http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-german
> 

- -- 
Michael Kasten | http://m-kasten.de
Im wirklichen Leben gibt es kein [Strg]+[Z]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.22 (GNU/Linux)

iQEcBAEBAgAGBQJWqJQYAAoJEF1/iIvWnG8NcAoH/iDa9WYUM/eTzyKpXpsoVimG
PoD/vpS2nJlMZ7gEU7Qz42AzhRXRoS/GPsXB3cxJDs99goQDzSClgt9CAZ/+M2PG
4zz3F8j3FGXMktMSbcdnD+u0UJ9gPk6vPJy5dHnRjvjdXc5xtH19KCT/gd1rvjhi
AN+hYnqOOyl7jOTgSGD8e6PYTXwoBP8hwXPKsTHZNJhCdFKjTClWnf052XTiRQGQ
OXYWsteyowztTm+PqE0RfJXbYf89hLcZhqgjc8drpss9rtpAMIf+lmhMVSK8sj0V
0fUjmlPtr3/Km8EZQ1G0R0MrSCOObqzaaQhm2gItUjHXjM1vlQGISZ828QWyx0s=
=sv36
-----END PGP SIGNATURE-----


More information about the TYPO3-german mailing list