Share
Heute möchte ich mich kurz auf etwas konzentrieren, das uns alle betrifft, aber nicht speziell auf Code bezogen ist. Ich beziehe mich auf die Leute, die die traditionellen Bücher und Zeitschriftenartikel beauftragen, die Sie täglich lesen und lernen.
Was Sie möglicherweise nicht erkennen, ist, dass Publisher tendenziell überraschend strikte Richtlinien für Autoren durchsetzen.
Für diejenigen von Ihnen, die noch nicht zu einem technischen Buch oder einer Zeitschrift beigetragen haben - oder sogar zu einigen kommerziellen Blogs - wissen Sie vielleicht nicht, dass Verleger die Tendenz haben, den Autoren überraschend strikte Richtlinien durchzusetzen.
Die oben genannten Punkte stellen nur einen kleinen Teil der Einschränkungen dar, die auf den Schultern eines technischen Autors liegen. Daraus lässt sich Folgendes ableiten: Neben der Entschlüsselung, wie sehr komplexe Technologien am besten zu erklären sind, muss ein technischer Redakteur es irgendwie schaffen, seinen Inhalt innerhalb der Grenzen der verwirrenden vorgegebenen Richtlinien eines Verlages zu finden.
Für die Vereisung des Falls - und um noch mehr Druck auf den Autor auszuüben - werden verschiedene (ziemlich intensive) Fristen gesetzt, um sicherzustellen, dass das Buch pünktlich fertiggestellt wird. Obwohl dies sicherlich verständlich ist, neigen die Verleger oftmals zu ehrgeizigen Terminen, die nicht den Vollzeitjob des Verfassers und andere Verantwortlichkeiten berücksichtigen.
Dieses Modell ist veraltet und steht kurz vor dem Aussterben, wenn es nicht adressiert und modernisiert wird.
Code zu lehren ist in vielerlei Hinsicht eine Kunst.
Bevor wir uns weiterhin mit traditionellen Verlagen beschäftigen, ist es wichtig, zuerst zu verstehen Warum Sie machen das. Stellen Sie sich ein Magazin mit einer begrenzten Anzahl von Seiten vor, die für einen bestimmten Inhalt verfügbar sind - beispielsweise fünf Seiten. Wenn dies die einzige Einschränkung wäre, wäre es für den Verfasser immer noch schwierig. Code zu lehren ist in vielerlei Hinsicht eine Kunst. Es erfordert sowohl ein Verständnis der Technologie als auch die Fähigkeit, sie so zu erklären, dass jeder sie verstehen kann. Wie setzt man ein beliebiges Wort auf Kunst und Erklärung? Nun, die Antwort ist, dass Sie es nicht können - zumindest nicht ohne erhebliches Aufgeben und Bearbeiten.
Lass uns weitergehen; Nun, da wir festgestellt haben, dass das Magazin X nur fünf Seiten Platz hat, besteht die nächste Einschränkung darin, einen Weg zu finden, Ihren Artikel in eine vordefinierte Layoutvorlage zu stopfen, das heißt, förderlich Jede Art, Form oder Form des Schreibvorgangs. Hier kommen die Anforderungen an die Anzahl der Bilder und die Anzahl der einzelnen Abschnitte zum Tragen.
Stellen Sie sich vor, Sie müssten beschreiben, wie dieser Code in 25 bis 35 Wörtern funktioniert. Erledigt? Stellen Sie sich nun die Opfer vor, die Sie bringen müssten, um Ihre Erklärung so zu ärgern, dass sie diesen Anforderungen entspricht. Wer profitiert davon??
Der Nachteil liegt darin, dass diese Vorlagen und Makros den Schreibprozess nicht berücksichtigen.
Aus der Sicht eines Nicht-Autors ist es vollkommen verständlich, warum es notwendig sein könnte, diese Einschränkungen festzulegen. Betrachten Sie die Verlage, die hunderte von Büchern pro Jahr organisieren und bearbeiten. In diesen Fällen wird es für die eigene Vernunft schnell unabdingbar, Vorlagen und wesentlich komplexe Word-Dokumente und -Makros vorzubereiten, um so viel wie möglich zu automatisieren.
Der Nachteil liegt darin, dass diese Vorlagen und Makros nicht einmal den Schreibprozess berücksichtigen. Statt sich auf das Wesentliche zu konzentrieren (komplizierten Code zu erklären), muss der Autor stattdessen viel Zeit und Mühe aufwenden, um die Verwendung eines bestimmten Word-Makros oder das Formatieren seines Dokuments gemäß den Richtlinien des Verlags zu entschlüsseln.
Eines von drei Ergebnissen kann sich daraus ergeben, dass ein Verleger einem Verfasser Seiten mit Anforderungen auferlegt, die nichts anderes wollen, als anderen eine bestimmte Technologie beizubringen - und dabei möglicherweise die Hypothek bezahlen. (Wenn Sie der Meinung sind, dass die Verfasser Ihrer bevorzugten Fachbücher es für das Geld tun, denken Sie noch einmal darüber nach.)
Ich bin mir sicher, dass Sie raten können, welche der oben genannten Optionen die beliebteste ist.
Zu einem bestimmten Zeitpunkt hatte ich ähnliche Anforderungen an Nettuts + Mitwirkende.
Ich muss zugeben, ich hatte an einem bestimmten Punkt ähnliche Anforderungen an Nettuts + Mitwirkende und Mitarbeiter. Glücklicherweise stellt das Format eines Blogs natürlich weniger hohe Anforderungen. Die Anforderung an die Anzahl der Wörter pro Abschnitt ist für ein Blog dumm und bedeutungslos. Trotzdem habe ich bei der Vorbereitung neuer Tutorials immer noch auf die Anzahl der Wörter, die Bereitstellung von Bildern und die Verwendung einer speziellen Nettuts-spezifischen HTML-Vorlage Wert gelegt.
Warum? Aus dem gleichen Grund wie bei traditionellen Verlagen: Mein Job ist am einfachsten, wenn der Artikel zu meinem vorgegebenen Layout für einen Nettuts + -Artikel passt.
Was ich nicht berücksichtigte, war die Anzahl der potenziellen Autoren, die ich versehentlich wegschob, indem ich diese Anforderungen stellte. Wer hat ehrlich Zeit, im Rahmen der Vorlage eines anderen zu arbeiten? Wenn Zeit ein kostbares Gut ist (insbesondere für Personen mit bestehenden Vollzeitjobs und Familien), dienen diese Beschränkungen lediglich zur Abschreckung.
Mein einziges Ziel ist es heutzutage, bei der Erstellung neuer Inhalte den Schreibprozess für den Autor so mühelos und natürlich wie möglich zu gestalten.
Nun, da ich als Herausgeber von Nettuts + gereift bin, fordere ich bei der Arbeit mit neuen Autoren nur eine Markdown-Datei an, die für diejenigen, die nicht vertraut sind, eine Pseudo-Sprache ist, die Entwickler besonders bevorzugen. Markdown nimmt die visuellen Darstellungen und Formatierungen vollständig aus dem Schreibprozess heraus, wie es der Fall sein sollte - insbesondere in unserer Branche. Alternativ können sie, wenn sie sich mit Markdown nicht wohl fühlen, alles andere nutzen, um die Arbeit zu erledigen.
Nun, da ich als Herausgeber von Nettuts + gereift bin, fordere ich bei der Arbeit mit neuen Autoren nur eine Markdown-Datei an.
Vielleicht macht diese Methode etwas mehr Arbeit für mich, aber es lohnt sich absolut und positiv. Ich möchte, dass sich unsere Autoren auf nichts anderes konzentrieren, als komplizierte Technologien so effektiv wie möglich zu erklären. Wir kümmern uns um den Rest. Wenn nur alle Verlage ein ähnliches Modell übernommen hätten.
Accentsconagua