Guten Morgen, > > Früher™️ waren die Artikel zu HTML-Elementen oder CSS-Eigenschaften sehr viel beschreibender als heute. [](/images/0ce531ee-08d7-11ee-825e-b42e9947ef30.png) Jein, ich hab' in der alten Doku geschaut. Da gab's bei CSS ein Intro und dann die Seiten mit allen Eigenschaften untereinander. Viel Beschreibung gab's da nicht. Treppenstufen durch floats ,bzw. den Clearfix gab's dann wohl nur im Forum. > Heute muss ich nach der Lektüre von fast nichts [^1] oft mehreren Links folgen, um mir die benötigten Infos zusammenzusuchen. Und oft [^2] ist es dann erst der dritte oder vierte Link, der mich zur benötigten Zusatzinfo (zum Beispiel erlaubte Werte für Attribut XY) führt. Das war auch die Kritik an den beschreibenden Wiki-Seiten und **sollte** ja eigentlich mit den Referenzen gelöst worden sein. Dort hat man im Idealfall eine kurze Beschreibung und dann die Attribute oder Werte aufgelistet. Ein **"Siehe_auch"** leitet dann auf die Tutorials weiter. (*sollte es jedenfalls*) So sollte eigentlich jede Seite aufgebaut sein: [](/images/ce905468-08d7-11ee-918a-b42e9947ef30.png) > > Die alte Doku mag in dieser Hinsicht sehr geschwätzig gewesen sein und diverse Infos wieder und wieder aufgeführt haben, aber dafür habe ich – im Normalfall – alle notwendigen Informationen auf einer Seite gefunden. Das wäre wünschenswert! > > Heute sind solche ausführlicheren Texte in die Tutorials ausgelagert. Die sind aber an nicht wenigen Stellen nicht prominent verlinkt. Also suche ich nach Informationen über Attribut XY des Elements Z und muss dann, wenn ich Pech habe, noch einmal, von der Startseite des Bereichs aus aus, das passende Tutorial (auf)suchen. Ich verspreche, dass ich noch mal durchgehe. Auch an anderer Stelle wurde gewünscht, die Links auf die Tutorials durch Teasertexte zu ergänzen. > > Beispiel: Ich suche Informationen zu Werten in `value` eines `input` vom Typ `date`. Ich gehe in die HTML-Referenz und suche mir die [Seite für `input`](https://wiki.selfhtml.org/wiki/HTML/Elemente/input) heraus. Touché! Das input-Element mit seinen vielen Typen sprengt da die Ziele der Referenz! > Um an die Attribute zu kommen, muss ich an den Zwischenüberschriften „Siehe auch“ und „Weblinks“ vorbeiscrollen um unter der letzteren die Liste der erlaubten Attribute zu finden [^3]. Das ist unschön. Als wir die oberen Parameter von Tabelle auf dl umgestellt hatten, blieb diese Tabelle unten. Das hab' ich grad gefixt - vor "Siehe auch" > Ich benutze den Link für [das Attribut `type`](https://wiki.selfhtml.org/wiki/HTML/Attribute/type_\(input\)). Dort finde ich eine Tabelle mit allen möglichen Werten in einer kommaseparierten Liste. Dann ist schluss. Mist, nur ein l auf die Element-Referenz. Ich habe hier Links zu den entsprechenden Tutorials eingefügt. > Ich vermute, dieser Inhalt ist in ein Tutorial eingegangen. Für mich ist er aber dorthin verschwunden, denn einen Link zum passenden Tutorial finde ich auf der Seite nicht Ja, schade! Ist hier gefixt - ich schau' die Tage, ob das noch woanders fehlt und trage das nach! > und auch auf der [Übersichtsseite der Tutorials zu Formularen](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare) finde ich erst auf den zweiten Blick eines, das mich anspringt und sagt „***Hier*** findest du die von dir benötigten Infos!“. Wobei es mich äußerst verwirrt, dass ich dieses [Tutorial zu `input`](HTML/Tutorials/Formulare/input) nicht unter der Überschrift „HTML/Tutorials/Formulare“ finde, sondern unter der Kette von der Zwischenüberschrift „Siehe auch“, über die Unterüberschrift „Tutorials“ zur Unterunterüberschrift „HTML“. Wir haben nach 2018 die vielen Einzeltutorials zu Kursen oder Reihen zusammengefügt. Spätestens bei 6-8 Kapiteln ist aber Schluss mit der Übersicht. Da müsste hier stärker herausgearbeitet werden, dass … a. [**HTML/Tutorials/Formulare**](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare) erklärt, wie Formulare funktionieren und wie sie gestaltet werden b. in [HTML/Tutorials/Formulare/**input**](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare/input) die einzelnen Typen vorgestellt werden > > Das war jetzt nur ein Beispiel und ich habe die Doku nicht durchgeackert, um weitere solche oder auch Gegenbeispiele, bei denen die Wege sehr viel klarer sind, zu finden. Bitte helf' uns und tu das! > Das ist auch nichts, was man mal so eben ändert, zumal wenn das einem einmal gefassten Konzept widerspricht oder man selbst dieses Konzept nicht in seinen Einzelheiten kennt. *Ich* denke, da gibt es Diskussions- und Änderungsbedarf. > > … dann könnte man höchstens darüber nachdenken, aus der Referenz heraus klarer auf die relevanten Tutorials zu verlinken. Im "Siehe auch" mag das untergehen. > > Ja, ein Anfang wäre mMn, wenn Links zu Tutorials grundsätzlich einen beschreibenden Text haben, wie es beim [Tutorial zu `input`](HTML/Tutorials/Formulare/input) unter „Siehe auch“ beim Link zu „Was ist ein Webformular?“ zu sehen ist [^4]. Das ist zwar auch nicht ideal, weil *für mich* dieser Link als hierarchischer Unterpunkt des Links zu „HTML/Tutorials/Formulare“ ein wenig untergeht, aber besser als ein nackter Link, der „nur“ mit einem Seitentitel beschriftet ist, ist es allemal. Ich glaube, dass das Konzept der „schnellen-Überblicksseiten“ und der darauf aufbauenden Tutorials-Reihen gut ist. Es muss halt immer wieder überprüft und vor allem auf gute Verlinkung geachtet werden! > > --- > > So, genug ausgekotzt. > > Tschö, Auge Danke für die Rückmeldung! Du hast einen Fehler gefunden, den wegen Deines Feedbacks andere nicht mehr machen müssen! > > [^1]: „Fast nichts“ im Sinne von sehr wenig zusätzlichen Infos, die auf den Seiten von Elementen oder Eigenschaften selbst zu finden sind. > [^2]: „Oft“ im Sinne von „machmal“, jedoch nicht im Sinne von „selten“. > [^3]: Das ist *für mich* eine unerwartete Stelle für diese Tabelle. > [^4]: Auch hier gilt, dass ich die Doku nicht akut durchgeschaut habe, um weitere und Gegenbeispiele zu finden. Herzliche Grüße Matthias Scharwies -- Ich habe heute rausgefunden, dass in das Pizzafach meines Rucksacks auch ein Laptop passt!

Guten Morgen, > > Früher™️ waren die Artikel zu HTML-Elementen oder CSS-Eigenschaften sehr viel beschreibender als heute. [](/images/0ce531ee-08d7-11ee-825e-b42e9947ef30.png) Jein, ich hab' in der alten Doku geschaut. Da gab's bei CSS ein Intro und dann die Seiten mit allen Eigenschaften untereinander. Viel Beschreibung gab's da nicht. Treppenstufen durch floats ,bzw. den Clearfix gab's dann wohl nur im Forum. > Heute muss ich nach der Lektüre von fast nichts [^1] oft mehreren Links folgen, um mir die benötigten Infos zusammenzusuchen. Und oft [^2] ist es dann erst der dritte oder vierte Link, der mich zur benötigten Zusatzinfo (zum Beispiel erlaubte Werte für Attribut XY) führt. Das war auch die Kritik an den beschreibenden Wiki-Seiten und **sollte** ja eigentlich mit den Referenzen gelöst worden sein. Dort hat man im Idealfall eine kurze Beschreibung und dann die Attribute oder Werte aufgelistet. Ein **"Siehe_auch"** leitet dann auf die Tutorials weiter. (*sollte es jedenfalls*) So sollte eigentlich jede Seite aufgebaut sein: [](/images/ce905468-08d7-11ee-918a-b42e9947ef30.png) > > Die alte Doku mag in dieser Hinsicht sehr geschwätzig gewesen sein und diverse Infos wieder und wieder aufgeführt haben, aber dafür habe ich – im Normalfall – alle notwendigen Informationen auf einer Seite gefunden. Das wäre wünschenswert! > > Heute sind solche ausführlicheren Texte in die Tutorials ausgelagert. Die sind aber an nicht wenigen Stellen nicht prominent verlinkt. Also suche ich nach Informationen über Attribut XY des Elements Z und muss dann, wenn ich Pech habe, noch einmal, von der Startseite des Bereichs aus aus, das passende Tutorial (auf)suchen. Ich verspreche, dass ich noch mal durchgehe. Auch an anderer Stelle wurde gewünscht, die Links auf die Tutorials durch Teasertexte zu ergänzen. > > Beispiel: Ich suche Informationen zu Werten in `value` eines `input` vom Typ `date`. Ich gehe in die HTML-Referenz und suche mir die [Seite für `input`](https://wiki.selfhtml.org/wiki/HTML/Elemente/input) heraus. Touché! Das input-Element mit seinen vielen Typen sprengt da die Ziele der Referenz! > Um an die Attribute zu kommen, muss ich an den Zwischenüberschriften „Siehe auch“ und „Weblinks“ vorbeiscrollen um unter der letzteren die Liste der erlaubten Attribute zu finden [^3]. Das ist unschön. Als wir die oberen Parameter von Tabelle auf dl umgestellt hatten, blieb diese Tabelle unten. Die muss ich nach oben bringen - vor "Siehe auch" > Ich benutze den Link für [das Attribut `type`](https://wiki.selfhtml.org/wiki/HTML/Attribute/type_\(input\)). Dort finde ich eine Tabelle mit allen möglichen Werten in einer kommaseparierten Liste. Dann ist schluss. Mist, nur ein l auf die Element-Referenz. Ich habe hier Links zu den entsprechenden Tutorial eingefügt. > Ich vermute, dieser Inhalt ist in ein Tutorial eingegangen. Für mich ist er aber dorthin verschwunden, denn einen Link zum passenden Tutorial finde ich auf der Seite nicht Ja, schade! Ist hier gefixt - ich schau' die Tage, ob das noch woanders fehlt und trage das nach! > und auch auf der [Übersichtsseite der Tutorials zu Formularen](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare) finde ich erst auf den zweiten Blick eines, das mich anspringt und sagt „***Hier*** findest du die von dir benötigten Infos!“. Wobei es mich äußerst verwirrt, dass ich dieses [Tutorial zu `input`](HTML/Tutorials/Formulare/input) nicht unter der Überschrift „HTML/Tutorials/Formulare“ finde, sondern unter der Kette von der Zwischenüberschrift „Siehe auch“, über die Unterüberschrift „Tutorials“ zur Unterunterüberschrift „HTML“. Wir haben nach 2018 die vielen Einzeltutorials zu Kursen oder Reihen zusammengefügt. Spätestens bei 6-8 Kapiteln ist aber Schluss mit der Übersicht. Da müsste hier stärker herausgearbeitet werden, dass … a. [**HTML/Tutorials/Formulare**](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare) erklärt, wie Formulare funktionieren und wie sie gestaltet werden b. in [HTML/Tutorials/Formulare/**input**](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare/input) die einzelnen Typen vorgestellt werden > > Das war jetzt nur ein Beispiel und ich habe die Doku nicht durchgeackert, um weitere solche oder auch Gegenbeispiele, bei denen die Wege sehr viel klarer sind, zu finden. Bitte helf' uns und tu das! > Das ist auch nichts, was man mal so eben ändert, zumal wenn das einem einmal gefassten Konzept widerspricht oder man selbst dieses Konzept nicht in seinen Einzelheiten kennt. *Ich* denke, da gibt es Diskussions- und Änderungsbedarf. > > … dann könnte man höchstens darüber nachdenken, aus der Referenz heraus klarer auf die relevanten Tutorials zu verlinken. Im "Siehe auch" mag das untergehen. > > Ja, ein Anfang wäre mMn, wenn Links zu Tutorials grundsätzlich einen beschreibenden Text haben, wie es beim [Tutorial zu `input`](HTML/Tutorials/Formulare/input) unter „Siehe auch“ beim Link zu „Was ist ein Webformular?“ zu sehen ist [^4]. Das ist zwar auch nicht ideal, weil *für mich* dieser Link als hierarchischer Unterpunkt des Links zu „HTML/Tutorials/Formulare“ ein wenig untergeht, aber besser als ein nackter Link, der „nur“ mit einem Seitentitel beschriftet ist, ist es allemal. Ich glaube, dass das Konzept der „schnellen-Überblicksseiten“ und der darauf aufbauenden Tutorials-Reihen gut ist. Es muss halt immer wieder überprüft und vor allem auf gute Verlinkung geachtet werden! > > --- > > So, genug ausgekotzt. > > Tschö, Auge Danke für die Rückmeldung! Du hast einen Fehler gefunden, den wegen Deines Feedbacks andere nicht mehr machen müssen! > > [^1]: „Fast nichts“ im Sinne von sehr wenig zusätzlichen Infos, die auf den Seiten von Elementen oder Eigenschaften selbst zu finden sind. > [^2]: „Oft“ im Sinne von „machmal“, jedoch nicht im Sinne von „selten“. > [^3]: Das ist *für mich* eine unerwartete Stelle für diese Tabelle. > [^4]: Auch hier gilt, dass ich die Doku nicht akut durchgeschaut habe, um weitere und Gegenbeispiele zu finden. Herzliche Grüße Matthias Scharwies -- Ich habe heute rausgefunden, dass in das Pizzafach meines Rucksacks auch ein Laptop passt!

Guten Morgen, > > Früher™️ waren die Artikel zu HTML-Elementen oder CSS-Eigenschaften sehr viel beschreibender als heute. [](/images/0ce531ee-08d7-11ee-825e-b42e9947ef30.png) Jein, ich hab' in der alten Doku geschaut. Da gab's bei CSS ein Intro und dann die Seiten mit allen Eigenschaften untereinander. Viel Beschreibung gab's da nicht. Treppenstufen durch floats ,bzw. den Clearfix gab's dann wohl nur im Forum. > Heute muss ich nach der Lektüre von fast nichts [^1] oft mehreren Links folgen, um mir die benötigten Infos zusammenzusuchen. Und oft [^2] ist es dann erst der dritte oder vierte Link, der mich zur benötigten Zusatzinfo (zum Beispiel erlaubte Werte für Attribut XY) führt. Das war auch die Kritik an den beschreibenden Wiki-Seiten und **sollte** ja eigentlich mit den Referenzen gelöst worden sein. Dort hat man im Idealfall eine kurze Beschreibung und dann die Attribute oder Werte aufgelistet. Ein "Siehe_auch"** leitet dann auf die Tutorials weiter. So ollte eigentlich jede Seite aufgebaut sein: [](/images/ce905468-08d7-11ee-918a-b42e9947ef30.png) > > Die alte Doku mag in dieser Hinsicht sehr geschwätzig gewesen sein und diverse Infos wieder und wieder aufgeführt haben, aber dafür habe ich – im Normalfall – alle notwendigen Informationen auf einer Seite gefunden. Das wäre wünschenswert! > > Heute sind solche ausführlicheren Texte in die Tutorials ausgelagert. Die sind aber an nicht wenigen Stellen nicht prominent verlinkt. Also suche ich nach Informationen über Attribut XY des Elements Z und muss dann, wenn ich Pech habe, noch einmal, von der Startseite des Bereichs aus aus, das passende Tutorial (auf)suchen. Ich verspreche, dass ich noch mal durchgehe. Auch an anderer Stelle wurde gewünscht, die Links auf die Tutorials durch Teasertexte zu ergänzen. > > Beispiel: Ich suche Informationen zu Werten in `value` eines `input` vom Typ `date`. Ich gehe in die HTML-Referenz und suche mir die [Seite für `input`](https://wiki.selfhtml.org/wiki/HTML/Elemente/input) heraus. Touché! Das input-Element mit seinen vielen Typen sprengt da die Ziele der Referenz! > Um an die Attribute zu kommen, muss ich an den Zwischenüberschriften „Siehe auch“ und „Weblinks“ vorbeiscrollen um unter der letzteren die Liste der erlaubten Attribute zu finden [^3]. Das ist unschön. Als wir die oberen Parameter von Tabelle auf dl umgestellt hatten, blieb diese Tabelle unten. Die muss ich nach oben bringen - vor "Siehe auch" > Ich benutze den Link für [das Attribut `type`](https://wiki.selfhtml.org/wiki/HTML/Attribute/type_\(input\)). Dort finde ich eine Tabelle mit allen möglichen Werten in einer kommaseparierten Liste. Dann ist schluss. Mist, nur ein l auf die Element-Referenz. Ich habe hier Links zu den entsprechenden Tutorial eingefügt. > Ich vermute, dieser Inhalt ist in ein Tutorial eingegangen. Für mich ist er aber dorthin verschwunden, denn einen Link zum passenden Tutorial finde ich auf der Seite nicht Ja, schade! Ist hier gefix - ich schau' die Tage, ob das noch woanders fehlt und trage das nach! > und auch auf der [Übersichtsseite der Tutorials zu Formularen](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare) finde ich erst auf den zweiten Blick eines, das mich anspringt und sagt „***Hier*** findest du die von dir benötigten Infos!“. Wobei es mich äußerst verwirrt, dass ich dieses [Tutorial zu `input`](HTML/Tutorials/Formulare/input) nicht unter der Überschrift „HTML/Tutorials/Formulare“ finde, sondern unter der Kette von der Zwischenüberschrift „Siehe auch“, über die Unterüberschrift „Tutorials“ zur Unterunterüberschrift „HTML“. Wir haben nach 2018 die vielen Einzeltutorials zu Kursen oder Reihen zusammengefügt. Spätestens bei 6-8 Kapitel ist aber Schluss mit der Übersicht. Das müsste hier stärker herausgearbeitet werden, dass a. [**HTML/Tutorials/Formulare**](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare) erklärt, wie Formulare funktionieren und wie sie gestaltet werden b. in [HTML/Tutorials/Formulare/**input**](https://wiki.selfhtml.org/wiki/HTML/Tutorials/Formulare/input) die einzelnen Typen vorgestellt werden > > Das war jetzt nur ein Beispiel und ich habe die Doku nicht durchgeackert, um weitere solche oder auch Gegenbeispiele, bei denen die Wege sehr viel klarer sind, zu finden. Bitte helf' uns und tu das! > Das ist auch nichts, was man mal so eben ändert, zumal wenn das einem einmal gefassten Konzept widerspricht oder man selbst dieses Konzept nicht in seinen Einzelheiten kennt. *Ich* denke, da gibt es Diskussions- und Änderungsbedarf. > > … dann könnte man höchstens darüber nachdenken, aus der Referenz heraus klarer auf die relevanten Tutorials zu verlinken. Im "Siehe auch" mag das untergehen. > > Ja, ein Anfang wäre mMn, wenn Links zu Tutorials grundsätzlich einen beschreibenden Text haben, wie es beim [Tutorial zu `input`](HTML/Tutorials/Formulare/input) unter „Siehe auch“ beim Link zu „Was ist ein Webformular?“ zu sehen ist [^4]. Das ist zwar auch nicht ideal, weil *für mich* dieser Link als hierarchischer Unterpunkt des Links zu „HTML/Tutorials/Formulare“ ein wenig untergeht, aber besser als ein nackter Link, der „nur“ mit einem Seitentitel beschriftet ist, ist es allemal. Ich glaube, dass das Konzept der „schnellen-Überblicksseiten“ und der darauf aufbauenden Tutorials-Reihen gut ist. Es muss halt immer wieder überprüft und vor allem auf gute Verlinkung geachtet werden! > > --- > > So, genug ausgekotzt. > > Tschö, Auge Danke für die Rückmeldung! Du hast einen Fehler gefunden, den wegen Deines Feedbacks andere nicht mehr machen müssen! > > [^1]: „Fast nichts“ im Sinne von sehr wenig zusätzlichen Infos, die auf den Seiten von Elementen oder Eigenschaften selbst zu finden sind. > [^2]: „Oft“ im Sinne von „machmal“, jedoch nicht im Sinne von „selten“. > [^3]: Das ist *für mich* eine unerwartete Stelle für diese Tabelle. > [^4]: Auch hier gilt, dass ich die Doku nicht akut durchgeschaut habe, um weitere und Gegenbeispiele zu finden. Herzliche Grüße Matthias Scharwies -- Ich habe heute rausgefunden, dass in das Pizzafach meines Rucksacks auch ein Laptop passt!