Die grundsätzliche Art und Weise in der Dateien im Internet gespeichert und bereitgestellt werden zu verändern ist ein gewaltiges Unterfangen. Wir brauchen Deine Hilfe um die Zukunft zu erschaffen. Wir brauchen Hilfe beim Schreiben der Dokumentation, Organisatoren, Programmierer, Technologen und Spezialisten aller Art. Tritt unserem Discord bei und finde selbst heraus, wie Du in das Puzzle hineinpasst, die Zukunft zu erschaffen.
In der Ether-1 Gemeinschaft erwarten Dich konstruktiv geführte Diskussionen, regelmäßige Gelegenheit mit dem Entwicklerteam zu sprechen und, wie bereits erwähnt, wirst du viele Gelegenheiten finden, Dich einzubringen. Wir freuen uns über alle, die uns beitreten um uns mit ihrem Wissen und ihrer Tatkraft zu unterstützen. Informiert euch genauer über das Projekt (ein guter Start dafür ist das whitepaper), macht euch mit der Community vertraut und findet heraus, wo ihr euch einbringen könnt, um uns zu unterstützen. Wir laden Dich herzlich ein, an unseren Diskussionen teil zunehmen und dich zu beteiligen.
Eine gute Möglichkeit, sich nützlich zu machen, ist gleich hier. Wir brauchen immer Hilfe dabei alle wissenswerten Dinge über das Projekt zu aufzuschreiben und zu organisieren. Du kannst dafür entschädigt werden & ETHO verdienen und und dem gesamten Projekt helfen zu wachsen! Sieh Dir den Wie kann man an der Doku mitarbeiten Artikel an und lies (& befolge!) unseren Style Guide für die Dokumentation.
FAQ: Wie kann man an der Doku mitarbeiten?
Ich möchte gerne bei der Ether-1 Dokumentation helfen!
Das ist fantastisch & und wir freuen uns, Dich dabei zu haben! Dieses Projekt setzt stark auf die Beteiligung leidenschaftlicher Personen. Du kannst über alles relevante passend zu den generellen Kategorien auf der linken Seite schreiben. Du kannst ebenso die bereits vorhandene Dokumentation verbessern und erweitern.
In welchem Format sollte ich schreiben?
Mach Dich zuerst mit der Syntax von Markdown Markup vertraut. Dies ist das Format, in dem Deine Beiträge zur Ether-1 Dokumentation eingereicht werden müssen.
Wie übermittle ich meine Arbeit?
Du kannst Deine Arbeit and jeden Community Manager (CM) oder Projekt Manager (PM) in unserem Discord übermitteln oder Du postest Deinen Beitrag im #share-your-etho-content Kanal.
Kann ich auf diesem Portal einen eigenen Account bekommen um meine Arbeit direkt zu übermitteln?
Du kannst Deinen eigenen Account hier bekommen sobald Du einige Arbeiten eingesendet und eine gute Beziehung zu Deinem CM Kontakt aufgebaut hast.
Wieviel bekomme ich für meine Mitarbeit an der Ether-1 Dokumentation bezahlt?
Für neue Artikel in der Dokumentation bekommst Du zwischen 75 und 250 ETHO, abhängig von der Länge des Artikels, der Lesbarkeit, der Detailiertheit, der Fehlerfreiheit und anderen Kriterien. Für das Verbessern vorhandener Artikel bekommst Du zwischen 10 und 150 ETHO, abhängig von denselben Kriterien. Für das Übersetzen bereits vorhandener Artikel bekommst Du zwischen 50 und 200 ETHO, abhängig von deren Länge und Komplexität.
Beachte, daß alle endgültigen Entscheidungen über Deine Vergütung im Ermessen Deines CM's liegen. Wir werden stets bemüht sein, Mitwirkende fair zu entschädigen. Sollte es dennoch einmal zu einer Unstimmigkeit zwischen Schreiber und CM kommen, dann zieh bitte einen anderen CM zur Überprüfung und Lösung des Problems zu Rate.
Wie kann ich etwas an eurem System verbessern?
Du kannst jedes Teammitglied ansprechen und Deine Idee vorbringen oder Du nutzt den #suggestions Kanal im Discord.
Style Guide Regel #1: Beachte den Style Guide. Regel #2: Siehe Regel #1.
Diese Seite kann man nicht zusammenfassen. Der Style Guide muss komplett gelesen und befolgt werden. Abweichungen vom Style Guide sollten nur nach vorheriger Diskussion passieren, um den Style Guide entsprechend der praktischen Anforderungen zu verändern.
Durch die Verwendung eines Style Guides erscheint das Dokumentationsportal dem Leser in einheitlicher Struktur und Design. Ohne einen Style Guide müssten unsere Leser ihre Erwartungen entsprechend jedem Dokument neu anpassen. Das wiederum würde zu einer weniger idealen Leseerfahrung mit möglichen, unnötigen Fehlern und Versäumnissen führen.
Versuche so wenige Wörter zu verwenden wie möglich und dabei Deine Erklärungen trotzdem ausreichend zu beschreiben.
Sei konkret und lass wichtige Informationen und Überlegungen, die einer fundierten Entscheidung des Lesers zu Gute kommen könnten, nicht weg
Schreibe Schlüsselwörter für Benutzerhandlungen in Deinen Anweisungen fett gedruckt (Beispiel: Öffne Chrome, klicke oben in die Adresszeile und schreibe dort www.ether1.org hinein)
Benutze kursiven Text für Namen und Kurzreferenzen/Zitate
Benutze so viele Screenshots, wie möglich, um Deine Informationen so weit wie möglich visuell zu ergänzen und füge sie mit Deinen Anweisungen zu den Benutzerhandlungen in Fettdruck zusammen (siehe vorherige Richtlinie)
Benutze dreifache Code Tags um zwischen Terminal Kommandos, Texteditor Inhalten und Code Blöcken zu unterscheiden
Benutze einfache Code Tags um alles andere hervorzuheben, was Du für nötig hälst
Benutze Block-Zitate für Notizen, Kommentare und längere Zitate/Referenzen
Jedes nicht verbindende (es sei denn es wird als erstes Wort des Titels verwendet) Wort des Titels wird groß geschrieben (Beispiel: Dies ist ein Beispiel Titel)
Jedes Dokument beginnt mit einer Zusammenfassung, Einleitung oder mit einer Beschreibung, in der der Hintergrund des Dokuments und/oder der Kerninhalt erklärt werden. Die meisten Leute lesen nur diesen Bereich. Daher sollte er umso besser sein.
Überschriften beginnen beim #/1. Grad
Unterteile Deinen Inhalt in logische, kleinere Unterteile mit Überschrifen 2. und 3. Grades, um dem Leser zu helfen durch den Inhalt zu navigieren und nützliche Informationen schnell zu finden
Wann immer Du in diesem Dokumentations Portal etwas referenzierst, schliesse zur einfachen Handhabung immer den Link mit ein
Benutze gute und sinnvolle Beschreibungen für Deine Links
Wenn Du Dir mal nicht sicher bist, verlinke zum Nutzen des Lesers