Forum

Moderiert von: spinne
Forum Index
Dokumentation
     Dokumentation Allgemein
     Aufruf zum Thema Dokumentation!
Hilfe anzeigen
Hilfe anzeigen

Seite 1 2 nächste Seite 


Autor Druckerfreundliche DarstellungAufruf zum Thema Dokumentation!
Gast
Unregistrierter Benutzer
Aufruf zum Thema Dokumentation!

Geschrieben: 29.07.2007 01:58

Hallo Leute,
ich habe nach längerer (berufsbedingter Abwesenheit) hier wieder einmal reingelesen - und mir ist aufgefallen, dass offenbar das Thema "Doku" noch immer ein heißes ist - aktuell ist mir eine Antwort von Tine in Erinnerung "wir sind 3-5 Entwickler" - und ich frage mich, ob nicht auch ein paar Anwender (da schließe ich mich natürlich mit ein) nicht auch ein oder zwei Module oder ein paar Funktionen beschreiben könnten.

Wenn sich z.B. 50 User finden, die sich je ein Kapitel schnappen, ist das nicht mehr als 4-8 Stunden Arbeit für jeden einzeln (evtl. auch etwas mehr oder weniger, hängt vom Umfang des Moduls ab - die Mediengallerie z.B. ließe sich sicher nicht in der Zeit schaffen, aber genau solche "Monstren" könnte man weiter unterteilen).

Wenn ich es recht gesehen habe, sind alle offenen Punkte noch mit "ToDo" in der Doku gekennzeichnet - und damit leicht zu finden. Hier der Link zur Doku:http://daily.openphpnuke.info/docu/OPN%20Handbuch/deutsch_html/opndoc-de.html

Ich persönlich bin der Meinung, dass das OPN-Team uns allen sehr viel gegeben hat - und es an der Zeit ist, dem Team etwas zurückzugeben. Immerhin betreiben wir alle recht erfolgreich unsere Homepages mit OPN - und eine vollständige Doku kommt uns auch selbst zugute.

Vorschlag für die Vorgehensweise (bin für Gegenvorschläge bzw. Ergänzungen natürlich offen):
1) Freiwillige suchen sich aus der Doku Kapitel raus & posten in diesem Beitrag, wer sich um was kümmert (um Doppelgleisigkeiten zu vermeiden)
2) Jeder der mit seinem Teil fertig ist, postet die Fertigstellung seines Themas - und schickt sein Werk an das OPN-Team (bitte teilt mit, wo und wie ihr es haben wollt)
3) Das OPN-Team hat damit noch die Chance, etwaige nicht korrekte Einträge zu überarbeiten & dann in die Doku zu integrieren (vieles wird ja nur mittels try & error bzw. Annahmen erklärbar sein).

Irgendwo glaube ich gelesen zu haben, dass es Regeln dafür gibt, wie die Doku erstellt werden soll - @OPN-Team: Könnt ihr hier den Link einfügen?

Ich hoffe, dass sich viele finden, die ähnlich denken - ein Outing hier wäre hilfreich. Auch wenn wir nicht alles schaffen - wenn wir von (geschätzten) 60% auf 80% kommen, ist das schon ein großer Schritt, der auch weniger Fragen hier im Forum nach sich zieht - und damit den Entwicklern mehr Zeit gibt zu entwickeln...

Bevor ich mir selbst 1-2 Themen schnappe möchte ich noch die Diskussion abwarten, ob der Prozess so okay ist - oder ob jetzt alle über mich herfallen. Jedenfalls wollte ich das Thema einmal lostreten - und jeden daran erinnern, dass er sich selbst in das Projekt OPN aktiv einbringen kann!

Ciao,
Boby
[addsig]

[ Diese Nachricht wurde bearbeitet von: Boby am 29.07.2007 02:03 (Originaldatum 29.07.2007 01:58) ]

Zitieren Druckerfreundliche Darstellung nach oben
spinne
Registriert: 21.08.2003
Wohnort: Luzern


Sende eine Private Nachricht an spinne Besuche die Homepage von spinne
Aufruf zum Thema Dokumentation!

Geschrieben: 29.07.2007 13:56

Servus Boby,

sicher ist das immer noch ein heisses Thema, nur denke ich einfach das es nicht sehr viele geben wird die sich daran beteiligen würden, da spricht die Erfahrung, nur wenige sind bereit sich den (ich sag mal Umständen die es mit sich bringt) zu widmen.
Gestern habe ich erst wieder überlegt, wie man die ganze Sache einfacher halten kann, sodass sich eventuell mehr User daran beteiligen.
Ich habe mir gestern mal MediaWiki kurz angeschaut, und denke es wäre eine relativ gute Alternative zu dem Jetzigen.
Nur leider habe ich mich noch nicht wirklich mit dem MediaWiki auseinander gesetzt.
Wichtig dort wäre mir das dort dann eben auch nur die schreiben, korrigieren und hinzufügen die die entsprechenden Rechte dazu bekommen.

So schaut eine Seite im Einsatz ein http://spinnen.eigenarbeit.org/index.php?title=Hauptseite

und ich denke da liese sich bestimmt auch eine Dokumentation mit organisieren.
Hier mal der Link zur MediaWiki Webseite
http://www.mediawiki.org/wiki/MediaWiki

Ich persönlich wäre für jede Hilfe mehr wie Dankbar, weil mir jetzt seit dem ich fast wieder voll arbeiten gehe, schlicht weg die Zeit fehlt.

Lieben Gruss
Tine


Zitieren Druckerfreundliche Darstellung nach oben
ArthurDent
Registriert: 04.08.2005
Beiträge: 256


Sende eine Private Nachricht an ArthurDent Besuche die Homepage von ArthurDent
Aufruf zum Thema Dokumentation!

Geschrieben: 29.07.2007 17:52

Hi,

das mit der Idee das die User die Doku "vervollständigen" finde ich gut.

Ich finde auch die Idee mit dem Wiki gut, so weit wie ich weiß ist das bis jetzt etwas anders geregelt. Ich kann den Thread nur nicht finden

Die Wiki-Oberfläche hätte den Vorteil das "man" von überall aus darauf zugreifen könnte. Und es ist Betriebssystem unabhängig.
Ich nehme einfach mal an das viele User hier unter Windows "arbeiten", ich bin zu Hause komplett auf Linux umgestiegen.

Ich würde gerne helfen, soweit wie es meine Zeit zulässt.
Bin leider teilweise durch meinen Job etwas "länger" unterwegs.


Arthur



---------------------------------------------------
Life is a journey, not a guided tour

If you think technology can solve your problems you don't understand technology and you don't understand your problems.
(Bruce Schneier)

Really, I'm not out to destroy Microsoft. That will just be a completely unintentional side effect.
(Linus Torvalds)
---------------------------------------------------
Linux: Debian 2.6.37
Datenbank: MySQL - 5.5.22
Apache: 2.2
PHP: 5.3.27
OPN: 2.5.7 (Revision 6747)

Zitieren Druckerfreundliche Darstellung nach oben
spinne
Registriert: 21.08.2003
Wohnort: Luzern


Sende eine Private Nachricht an spinne Besuche die Homepage von spinne
Aufruf zum Thema Dokumentation!

Geschrieben: 29.07.2007 19:38

hmm also ich hab mir das wiki gerade mal installiert, aber so wirklich glücklich macht mich das nicht.
das müsste wenn dann etwas umprogrammiert werden, weil ich möchte einfach nicht das ein jeder darin rumschreibt, sondern wirklich auch nur diejenigen die dazu berechtigt sind.

das dingels hat nicht mal nen vernünftigen admin panel noch sonst irgendwas.

vielleicht hat ja von euch noch jemand eine alternativ-lösung

gruss tine


Zitieren Druckerfreundliche Darstellung nach oben
ArthurDent
Registriert: 04.08.2005
Beiträge: 256


Sende eine Private Nachricht an ArthurDent Besuche die Homepage von ArthurDent
Aufruf zum Thema Dokumentation!

Geschrieben: 29.07.2007 22:00

Hi tine,

schau dir bitte mal diese Seite an: WikiMatrix
Ein Vergleich von 4 Wiki-Systemen, die alle Page Permissions und ACLs haben.


Arthur



---------------------------------------------------
Life is a journey, not a guided tour

If you think technology can solve your problems you don't understand technology and you don't understand your problems.
(Bruce Schneier)

Really, I'm not out to destroy Microsoft. That will just be a completely unintentional side effect.
(Linus Torvalds)
---------------------------------------------------
Linux: Debian 2.6.37
Datenbank: MySQL - 5.5.22
Apache: 2.2
PHP: 5.3.27
OPN: 2.5.7 (Revision 6747)

Zitieren Druckerfreundliche Darstellung nach oben
manneS

Registriert: 03.02.2007
Beiträge: 22


Sende eine Private Nachricht an manneS
Aufruf zum Thema Dokumentation!

Geschrieben: 29.07.2007 22:18

Hallole,
ich benutze seit einiger Zeit PmWiki. Ist ein einfaches, aber durchdachtes Wiki, hat aber natürlich bei weitem kein solch granulares Rechtesystem wie OPN Aber ne sehr freundliche, aktive Community und scheint recht robust zu sein.


Zitieren Druckerfreundliche Darstellung nach oben
Gast
Unregistrierter Benutzer
Aufruf zum Thema Dokumentation!

Geschrieben: 01.08.2007 13:58

Erschreckenderweise ist die Bereitschaft an OPN mitzuwirken verdammt niedrig - oder es wissen sowieso fast alle außer mir, wie die nicht dokumentierten Module & Einstellungen funktionieren...

Trotzdem denke ich, dass ein WIKI sicher die beste Variante wäre, um anderen die Möglichkeit zu eröffnen, mitarbeiten zu KÖNNEN.

Ich bin der Meinung, dass das OPN-Team in sich gehen sollte um das Thema diskutieren. Vermutlich ist die gemeinsame Bearbeitung für das Core-Team in einem Wiki einfacher als die bisherige Lösung. Und der URL wiki.openphpnuke.info würde sich sogar regelrecht anbieten (und dazu noch intuitiv auffindbar sein )

Ciao,
Boby
[addsig]

Zitieren Druckerfreundliche Darstellung nach oben
Scout_GP

Registriert: 16.06.2005
Beiträge: 1054
Wohnort: Berlin


Sende eine Private Nachricht an Scout_GP Besuche die Homepage von Scout_GP
Aufruf zum Thema Dokumentation!

Geschrieben: 01.08.2007 14:21

Aus dem Urlaub zurück und wieder aktiv für OPN, sofern ich Zeit und auch etwas Lust habe.



Gruß Scout
+++ Last.fm | Scoutweb +++

Zitieren Druckerfreundliche Darstellung nach oben
Gast
Unregistrierter Benutzer
Aufruf zum Thema Dokumentation!

Geschrieben: 01.08.2007 15:01

@SCOUT: Stimmt - vielleicht ist Juli/August auch der falsche Zeitpunkt für einen solchen Aufruf...

Ciao,
Boby


Zitieren Druckerfreundliche Darstellung nach oben
mongfevned
Registriert: 24.06.2004
Beiträge: 162


Sende eine Private Nachricht an mongfevned
Aufruf zum Thema Dokumentation!

Geschrieben: 03.08.2007 13:41

ich hab mir nun mal so ca 10 wikis installed.... auf die schnelle seh ich eines das recht umfangreich ist und auche inen annehmbaren adminbereich: tikiwiki - testets das mal aus - scheint interessant zu sein. (bin leider ent zu mehr gekommen heute - mache am montag mal weiter )

lg, mong


Zitieren Druckerfreundliche Darstellung nach oben
sortieren nach
Seite 1 2 nächste Seite 

Hilfe anzeigen
Hilfe anzeigen
Vorheriges Thema:  Anleitungen - pdf
Nächstes Thema:  [OPN - WikiDoku]

Gehe zu:

Benutzername:
 
Sicherheits-Code
Sicherheits-Code
Neu laden