Seite 1 von 1

Vorschlag fürs Wiki

Verfasst: Mittwoch 1. März 2006, 15:20
von qweet
Mein Vorschlag um einen Begriff all seine Assoziationen in der Gemeinschaft zu legen, ist ja nun nicht gerade auf Begeisterung gestoßen. Gut.

Was denkt ihr über eine Befehlsreferenz nach meiner Methode im Python-Wiki?

Wir würden also jeden Befehl einzeln definieren. Und wenn was falsches kommt, wirds halt wiki-mäßig rauseditiert.

Als eine Grundlage.

Verfasst: Mittwoch 1. März 2006, 16:12
von tiax
Du meinst sowas wie das bereits existierende Dokumentationswerk für Python, das genau die Informationen bereits enthält und das auch noch vollständig und korrekt? :wink:

Im speziellen ist damit das Python Reference Manual gemeint.

Verfasst: Mittwoch 1. März 2006, 16:21
von qweet
Ja.

- Das ist aber schon etwas älter: 28 September 2005.
- Außerdem wurde es nur von _einer_ Person geschrieben.
- es ist in englisch. Wir haben ein deutsche Wiki.
- ich vermisse eindeutige Erklärungen zu jedem einzelnen Befehl.

Wir hätten eine klare Referenz zu jedem einzelnen Befehl. Ich denke das kann man ausprobieren.

Verfasst: Mittwoch 1. März 2006, 16:32
von rayo
qweet hat geschrieben:Ja.

- Das ist aber schon etwas älter: 28 September 2005.
Was ist denn seit Python 2.4.2 neues dazu gekommen?
- Außerdem wurde es nur von _einer_ Person geschrieben.
Das denke ich wohl kaum, da haben sicher mehrere daran geschrieben
- es ist in englisch. Wir haben ein deutsche Wiki.
Ohne Englisch kommst du beim programmieren nicht weit.
- ich vermisse eindeutige Erklärungen zu jedem einzelnen Befehl.

Was fehlt dir genau? Ich hab bis jetzt alles in der Doku gefunden was ich brauche.

Gruss

Verfasst: Mittwoch 1. März 2006, 16:36
von CM
- Das ist aber schon etwas älter: 28 September 2005.
Und damit schon veraltet, obwohl es für die aktuelle Pythonversion ist?
- Außerdem wurde es nur von _einer_ Person geschrieben.
Stimmt nicht so ganz. Aber selbst wenn: Was ist so schlimm an der Tatsache an sich?
- es ist in englisch. Wir haben ein deutsche Wiki.
Lerne Englisch. Egal was man davon hält: Es ist nunmal die Lingua Franca in den Wissenschaften und der Programmiererei. Oder fertige halt eine Übersetzung an.
ich vermisse eindeutige Erklärungen zu jedem einzelnen Befehl.
Dir ist aber schon klar, daß es noch die Library Reference und den Global Modul Index gibt? Zudem ein Tutorial und einen haufen Bücher und Web-Resourcen (wie unter anderem dieses hier und "unser" wiki)?

Magst Du vielleicht noch einmal modelnines Erklärung durchleses, welche "Kommunikationsweise" wo am besten eingesetzt werden kann? Ist wirklich nicht schlecht ...

Gruß,
Christian

Verfasst: Mittwoch 1. März 2006, 20:10
von qweet
CM hat geschrieben: Dir ist aber schon klar, daß es noch die Library Reference und den Global Modul Index gibt? Zudem ein Tutorial und einen haufen Bücher und Web-Resourcen (wie unter anderem dieses hier und "unser" wiki)?
ja. aber so hätte man die möglichkeit neben den standard-definitionen die schon exestieren auch noch seine eigenen erfahrungen mit einfließen zu lassen. und genau das denke ich, ist es was wertvoll ist.

ich denke, das ganze würde somit menschlicher werden und nicht so roh und trocken definiert.

Verfasst: Donnerstag 2. März 2006, 06:13
von mitsuhiko
qweet hat geschrieben:ja. aber so hätte man die möglichkeit neben den standard-definitionen die schon exestieren auch noch seine eigenen erfahrungen mit einfließen zu lassen. und genau das denke ich, ist es was wertvoll ist.
... :-|

Verfasst: Donnerstag 2. März 2006, 09:03
von qweet
Ja.

Nachdem man alle Standard-definition zB zu
'print'
aufgeschrieben hat. So wie
print ist in der Bibliothek...
print hat die Funktion...

nachdem also die Normal-Definitionen gefallen sind, kann man das Ganze vielleicht noch mit eigenen Beispielen anreichern:
print lässt sich zB so anwenden.
print kann man auch so nutzen
print lässt sich auch so kombinieren.

so mein ich das. Einfach das trockene noch mit eigenen Beispielen etwas abschmecken.

Verfasst: Donnerstag 2. März 2006, 09:15
von mitsuhiko
qweet hat geschrieben:print hat die Funktion...
print is a fucking keyword. :x And nothing else.

This forum doesn't need your fucking improvements and fucking threads in the fucking offtopic :evil:

SHUT UP!!!!

Verfasst: Donnerstag 2. März 2006, 09:54
von CM
qweet hat geschrieben: ich denke, das ganze würde somit menschlicher werden und nicht so roh und trocken definiert.
Nein, blackbird, für ein derartiges Anliegen sollten wir natürlich Verständnis haben. Rohe und trockene Programmierarbeit braucht ein menschliches Antlitz! Insbesondere die plumpe englische Sprache hat wohl langsam aber sicher in den Handbüchern ausgedient. Es wird Zeit, daß das einmal gesagt wird.

SCNR
Christian (ohne das geringste Zeichen von Ironie :wink: )

Verfasst: Donnerstag 2. März 2006, 10:14
von N317V
Jetzt kribbelts mich doch in den Fingern:
Wir könnten die Python-Doku auch verfilmen oder besser vielleicht zuerst einen Comic machen. SCNR

Verfasst: Donnerstag 2. März 2006, 10:17
von qweet
Ooohhh Leute.

Programmieren bedeutet für mich nun einmal designen von Lösungen.

Und dazu müssen die Grundlagen, mMn einfach und klar sein. Leicht und verständlich.

Verfasst: Donnerstag 2. März 2006, 10:20
von Francesco
blackbird hat geschrieben:
qweet hat geschrieben:print hat die Funktion...
print is a fucking keyword. :x And nothing else.

This forum doesn't need your fucking improvements and fucking threads in the fucking offtopic :evil:

SHUT UP!!!!
Relax. :)

This forum isn't intended to start endless discussions. Ok.
But I for me simple ignore it (with this post I make an exception).
Nobody is forced to follow it.

For me in own words:
print is a keyword to emit the assigned string to sys.stdout.

====

Strange BTW:

Code: Alles auswählen

>>> help (dir)
...

Code: Alles auswählen

>>> help (print)
  File "<input>", line 1
    help (print)
              ^
SyntaxError: invalid syntax
>>
:?

Can someone duplicate this?

Verfasst: Donnerstag 2. März 2006, 10:33
von BlackJack
Francesco hat geschrieben: Strange BTW:

Code: Alles auswählen

>>> help (dir)
...

Code: Alles auswählen

>>> help (print)
  File "<input>", line 1
    help (print)
              ^
SyntaxError: invalid syntax
>>
:?

Can someone duplicate this?
Na klar. ``print`` ist eben ein Schlüsselwort und das als Parameter für einen Funktionsaufruf eben syntaktisch an der falschen Stelle. Versuch's mal mit ``help('print')`` (man beachte die Anführungszeichen).

Verfasst: Donnerstag 2. März 2006, 10:35
von chaos
qweet hat geschrieben:Ooohhh Leute.

Programmieren bedeutet für mich nun einmal designen von Lösungen.
Ok.
Und dazu müssen die Grundlagen, mMn einfach und klar sein. Leicht und verständlich.
Dann lies das offizielle Handbuch! (ooder ein bel. anderes Buch über Python, das im Handel käuflich zu erwerben ist).

Verfasst: Donnerstag 2. März 2006, 10:42
von Francesco
BlackJack hat geschrieben:
Francesco hat geschrieben: Strange BTW:

Code: Alles auswählen

>>> help (dir)
...

Code: Alles auswählen

>>> help (print)
  File "<input>", line 1
    help (print)
              ^
SyntaxError: invalid syntax
>>
:?

Can someone duplicate this?
Na klar. ``print`` ist eben ein Schlüsselwort und das als Parameter für einen Funktionsaufruf eben syntaktisch an der falschen Stelle. Versuch's mal mit ``help('print')`` (man beachte die Anführungszeichen).
Danke für die Info. :) :oops:

Verfasst: Donnerstag 2. März 2006, 10:43
von N317V
Francesco hat geschrieben: This forum isn't intended to start endless discussions. Ok.
But I for me simple ignore it (with this post I make an exception).
Nobody is forced to follow it.
It is annoying, though.
Francesco hat geschrieben: ====

Strange BTW:

Code: Alles auswählen

>>> help (dir)
...

Code: Alles auswählen

>>> help (print)
  File "<input>", line 1
    help (print)
              ^
SyntaxError: invalid syntax
>>
:?

Can someone duplicate this?
help on any keyword or topic brings up the following message when typed into the interactive help:
Sorry, topic and keyword documentation is not available because the Python
HTML documentation files could not be found. If you have installed them,
please set the environment variable PYTHONDOCS to indicate their location.
It works with functions but I couldn't get it to work with keywords or topics. Setting the variable doesn't help at all.

Verfasst: Donnerstag 2. März 2006, 10:47
von Francesco
Sorry, topic and keyword documentation is not available because the Python
HTML documentation files could not be found. If you have installed them,
please set the environment variable PYTHONDOCS to indicate their location.
It works with functions but I couldn't get it to work with keywords or topics. Setting the variable doesn't help at all.
Welchen Wert hat die Umgebungsvariable bei dir?
Bei mir ist es (auf Windows):

Console öffnen

Code: Alles auswählen

set
...
PYTHONDOCS=C:\Python24\Doc\

Verfasst: Donnerstag 2. März 2006, 10:54
von N317V
@Francesco: Genau wie bei mir. Vielleicht mal bei Gelegenheit neu starten. :-/