Projekt piTelex - BONTelex und andere artfremde Empfangsgeräte Thema ist als GELÖST markiert

[detlef]

Das geht mir bei meinen Software-Projekten auch manchmal so. Was für mich absolut eindeutig ist, erschließt sich manchen Anwendern überhaupt nicht.

[MCMLXXV]

Ja, das kenne ich. Ok, Software selbst schreiben kann ich nicht. Aber teilweise beim Aufspielen neuer Software auf Geräte stellt man auch Sachen fest, die eindeutig in ne Doku gehören. Im Instandhaltungswesen bei der Bahn hatten wir echt mal ein Treffen mit Mitarbeitern mehrerer Werkstätten um über solche Doku-Fehler oder -Verbesserungen zu sprechen, was dann aber auch wirklich von den Ingenieuren umgesetzt wurde.....

[obrecht]

Code: Alles auswählen

      # WARNING
      # Setting tns-dynip-number to anything except 0 will enable dynamic IP
      # updates with i-Telex TNS (Teilnehmerserver, Subscriber Server).
      #
      # Leave at 0 if you've chosen a static TNS entry!
      # Change to something nonzero if and only if
      # - you've got your number approved by i-Telex administrators, and
      # - you've chosen dynamic IP update and told i-Telex administrators so, and
      # - you've set your TNS pin properly.
     "tns-dynip-number": 211234,

Das wäre nochmal eine Sache, die im Kommentar klarer beschrieben werden könnte. Da steht nichts von einer i-Telex-Nummer.

Also das Wiki sagt ziemlich eindeutig zu tns-dynip-number:

Initially 0 (disable dynamic IP update). Set to own i-Telex calling number to enable dynamic IP update – must be agreed on with i-Telex administrators.

RTFM.... manchmal findet man da tatsächlich was

[detlef]

Initially 0 (disable dynamic IP update). Set to own i-Telex calling number to enable dynamic IP update – must be agreed on with i-Telex administrators.

RTFM.... manchmal findet man da tatsächlich was

Dass Anleitungen im Zweifelsfall nicht gelesen werden, das weiß man ja.
Es wäre ja kein großes Problem, diesen einen Satz in die Config zu übernehmen.

Es geht ja nicht darum (wie bei CE-Anleitungen) dem Anwender hinterher nachzuweisen, dass es irgendwo gestanden hat.
Es geht darum, es dem Anwender möglichst einfach zu machen. Jeder zusätzliche Hinweis ist hilfreich.

[obrecht]

Dass Anleitungen im Zweifelsfall nicht gelesen werden, das weiß man ja.

Na danke für die Blumen und die Ermutigung, weiter an der Doku zu schrauben...

Es wäre ja kein großes Problem, diesen einen Satz in die Config zu übernehmen.

Nein. Kann ich gerne machen. Aber du kannst soviel du willst in die Beispiel Config schreiben: Ohne RTFM wirst du mit piTelex nicht glücklich werden, genau wie bei vielen anderen Dingen.
Jochen hat den Versuch einer umfassend kommentierten Config auch zugunsten von Einzelschnipseln aufgegeben, weil die Konfig mit all den Kommentaren nicht mehr lesbar war. Das hätte ebenfalls zu Maulern geführt.

Und in der Beispileconfig steht zu tns-dynip-number ganz klar:
"Lass die Finger von der Defaulteinstellung "0" außer du hast die explizite Genehmigung der TNS Admins."
Das sollte Motivation genug sein, in der Doku nach "mehr" zu fahnden. Vielleicht sollte ich die Doku an der Stelle noch etwas aufbohren. Das wäre mMn die bessere Alternative. Kann ich aber erst nächste Woche machen...

[detlef]

Nein. Kann ich gerne machen. Aber du kannst soviel du willst in die Beispiel Config schreiben: Ohne RTFM wirst du mit piTelex nicht glücklich werden, genau wie bei vielen anderen Dingen.

RTFM funktioniert leider nicht. Und jegliche Versuche, Anwender zu erziehen, funktoinieren ebenfalls nicht. Jeder Anwender hat seine eigenen Erfahrungen, sein eigene Denke und seine eigene Vorgehensweise. Im Idealfall holt man die alle ab, in dem man die Informationen mehrfach und in unterschiedlicher Form zur Verfügung stellt. Für die Leute, die gerne stundenlang Dokus lesen, steht es im Wiki. Die anderen finden es in der Config.

Ich bin da auch sehr eigen und beharre auf Grund meine Erfahrung oft auf bestimmten Vorgehensweise, die ich mir über die Zeit angewöhnt habe. Komplette Dokus zu lesen gehört nicht mehr dazu.

[MCMLXXV]

Das wäre nochmal eine Sache, die im Kommentar klarer beschrieben werden könnte. Da steht nichts von einer i-Telex-Nummer.

Also das Wiki sagt ziemlich eindeutig zu tns-dynip-number:

Initially 0 (disable dynamic IP update). Set to own i-Telex calling number to enable dynamic IP update – must be agreed on with i-Telex administrators.

RTFM.... manchmal findet man da tatsächlich was

Ja, ich gebs zu: danach hab ich im Wiki nicht gesucht.

Hätte ich wohl auch nicht wirklich verstanden da ich Englisch nicht so gut beherrsche und die paar vorhandenen Kenntnisse ziemlich eingerostet sind.
Technisches Englisch ist ja eh nochmal ne andere Nummer....

Normalerweise bin ich auch immer wieder irritiert wie wenige Menschen heute noch lesen können und vor allem das gelesene verstehen können.

[obrecht]

Ich bin da auch sehr eigen und beharre auf Grund meine Erfahrung oft auf bestimmten Vorgehensweise, die ich mir über die Zeit angewöhnt habe. Komplette Dokus zu lesen gehört nicht mehr dazu.

Das nennt man dann wohl ein OSI Level-8-Problem...