Technisches Schreiben für Startups ist wichtig: Hier erfahren Sie, warum

Willkommen zum ersten Blogbeitrag unserer neuen Reihe „ Wie technisches Schreiben Ihr Startup aufwerten kann “.

In dieser Serie zeige ich Ihnen, wie technisches Schreiben Start-ups zugute kommen kann, von der Gewinnung von Sichtbarkeit bis zum Aufbau von Vertrauen bei Ihrem Publikum. Als Anbieter von Schreibdiensten für Startups habe ich gesehen, welche positiven Auswirkungen gut gestaltete Inhalte haben können.

Heute beginne ich mit einem Überblick darüber, wie technisches Schreiben das Wachstum Ihres Startups steigern kann. Bleiben Sie dran für weitere Beiträge darüber, warum Schreiben ein wichtiges Werkzeug für Startups ist.

Technisches Schreiben spielt eine wichtige Rolle für den Erfolg eines Startups. Dabei geht es darum, eine klare, prägnante und benutzerorientierte Dokumentation zu erstellen, die erklärt, wie ein Produkt oder eine Dienstleistung funktioniert. „ Starke Ansichten, schwach vertreten. „Gehen Sie nach draußen, aber bleiben Sie auf der Suche nach abweichenden Meinungen von klugen und respektvollen Menschen.

Das Schreiben von Software liegt auf halbem Weg zwischen dem Schreiben eines Romans und dem Bau einer Brücke.

Technisches Schreiben toleriert und fördert sogar stilistische Eigenheiten, die im herkömmlichen Verlagswesen nicht berücksichtigt werden könnten. Lehne dich in sie hinein.

Technische Inhalte sind entweder aktuell oder zeitlos, es gibt fast nichts dazwischen.

Bildnachweis – „State of Developer Relations“ – den vollständigen Bericht finden Sie hier.

Die Person, die den Plan in einer Organisation/einem Startup aufschreibt, verfügt über enorme Macht. Wenn Sie die Nachwuchskräfte eines Technologieunternehmens finden möchten, schauen Sie sich an, wer den Plan schreibt. Auch wenn sie vielleicht nicht alle Ideen haben, wissen Sie, dass sie die Energie, Motivation und Fähigkeiten haben, Ideen in schriftlicher Form zu organisieren und zu kommunizieren.

Umgeben Sie sich und Ihr Startup mit „Querdenkern“, die nicht anders können, als unterschiedliche Perspektiven auf alles zu entwickeln, was sie in Ihrem Produkt oder Ihrer Dienstleistung sehen. Sie werden nicht immer Recht haben, aber sie stellen immer eine Herausforderung für Ihr Denken und Schreiben dar.

Investitionen in technisches Schreiben können einen erheblichen Einfluss auf den Erfolg Ihres Startups haben. Dies kommt nicht nur Ihren Benutzern zugute, sondern trägt auch zur Effizienz und Effektivität Ihrer internen Abläufe bei. Denken Sie daran, dass das Ziel darin besteht, eine Dokumentation zu erstellen, die für Ihr Zielpublikum klar, prägnant und verständlich ist. Dadurch werden die Zufriedenheit, Loyalität und das Geschäftswachstum der Benutzer steigen.

Denken Sie daran: Medienformate sind zyklisch. Nietzsche schrieb in Aphorismen und Twitter ist Aphorismen als Dienstleistung. Hip-Hop brachte die Poesie zurück. Montaigne war der Pionier des Aufsatzformats und Blogs brachten es wieder in Mode.

Startups sollten mehr Manifeste, Blogs, saubere Dokumente und Integrationsleitfäden schreiben.

Was ist Technisches Schreiben?

In den letzten drei Jahren habe ich hin und wieder an Dokumentationen, Integrationsleitfäden und technischen Blogbeiträgen für über 20 Startups gearbeitet. Ich begann während meiner Rolle als Entwickleranwalt bei SuperTokens – einer Alternative zu Auth0, Firebase Auth – im Jahr 2021 einen Beitrag zu leisten und half Entwicklern beim Übergang zur neuen Open-Source-Benutzerauthentifizierung.

Ich habe festgestellt, dass es mir Spaß macht, technische Blogs und Dokumentationen zu schreiben. Es ist befriedigend, qualitativ hochwertige technische Texte zu erstellen, die anderen zugute kommen.

Ich habe im Laufe der Jahre viele Ressourcen zum technischen Schreiben und zur Dokumentation gelesen. Ich habe darüber geschrieben , warum jeder Ingenieur schreiben sollte, und ich habe meine Notizen zusammengestellt, um mir später in meiner Karriere wichtige Punkte zu merken, aber auch als Hilfsmittel, um jetzt über das Schreiben nachzudenken.

GPT hat enthüllt, wie sehr das Schreiben reines Blödsinn ist. Langweilig, leblos, unaufschlussreich, harmlos und den Preis der Tinte, mit der es gedruckt wurde, nicht wert. Daher werden gute Autoren für Ihre Startups wichtiger, die hervorragende technische Blogs erstellen und schreiben können, und ChatGPT-Plagiate sind überhaupt kein Problem. Wenn Sie eine Maschine nicht überschreiben können, was machen Sie dann mit dem Schreiben?

Wenn Sie als Entwickler daran interessiert sind, technische Blogs zu schreiben, habe ich einen kompletten Blog darüber geschrieben , was technisches Schreiben ist und wie man gute technische Blogs schreibt .

Meine Schreibprinzipien

Beim technischen Schreiben versuche ich stets die folgenden Grundsätze im Hinterkopf zu behalten.

• Das Ziel des Schreibens besteht darin, Aufgaben für Benutzer so einfach und effizient wie möglich zu gestalten.
• Entwickler lassen sich lieber etwas zeigen als etwas sagen und lernen lieber durch Handeln.
• Verhelfen Sie Ihren Nutzern so schnell wie möglich zu ersten Erfolgen.
• Halten Sie es einfach und schreiben Sie in einfacher Sprache.

Warum ist technisches Schreiben für Startups wichtig?

Ich schreibe seit drei Jahren technische Inhalte. Folgendes habe ich gelernt:

• Klare technische Blogs und Dokumentationen helfen Endbenutzern, Ihr Produkt schnell und effizient zu verstehen, wodurch Frustrationen reduziert und die Zufriedenheit erhöht werden.

• Gründliches technisches Schreiben zeigt, dass Sie Ihr Produkt und Ihre Benutzer ernst nehmen. Es stärkt das Vertrauen und die Zuversicht Ihrer Marke.

• Neue Endbenutzer können sich schnell mit Ihrem Produkt vertraut machen, wenn sie Zugriff auf gut organisierte, leicht verständliche Anleitungen, Integrationen und Dokumente haben.

• Gut strukturierte technische Blogs und Dokumentationen verbessern die SEO Ihrer Website und helfen potenziellen Kunden, Sie leichter zu finden.

• Wenn Ihr Startup wächst, müssen Sie mehr Mitarbeiter einstellen. Gute technische Texte und Dokumentation sind für eine effiziente Schulung neuer Mitarbeiter unerlässlich.

• Hier sind einige Beispiele für hervorragende Ingenieurblogs:

• Der Cloudflare-Blog

• DoorDash Engineering-Blog

• Der Netflix-Tech-Blog

  
  

• Detaillierte technische Blogs und Dokumentationen zeigen, dass Sie über eine gut durchdachte Produkt- und Geschäftsstrategie verfügen, die potenzielle Investoren und Partner ansprechen kann.

• Das Feedback von Endbenutzern aus technischen Blogs und Dokumentationen ist oft von unschätzbarem Wert für die Verbesserung Ihres Produkts und die Identifizierung von Unklarheiten.

• Gut geschriebene Blogs und Dokumentationen können problemlos in andere lokale Sprachen übersetzt werden, sodass Sie ein breiteres, globales Publikum erreichen können.

• Überragende technische Blogs und Dokumentationen können ein wesentliches Unterscheidungsmerkmal sein und Ihnen einen Wettbewerbsvorteil verschaffen.

  
  

Gutes technisches Schreiben = organisches Entwicklermarketing

Entwickler haben den Ruf, dem Marketing abgeneigt zu sein, aber das stimmt nicht unbedingt.

Tatsächlich gewinnen Entwickler in Unternehmen jeder Größe an Kaufkraft und Ansehen. Arbeitgeber wissen, wie wichtig es ist, in Tools zu investieren, die Entwicklern dabei helfen, produktiv und zufrieden zu bleiben, denn gute Entwickler sind schwer zu finden und zu halten.

Die Vielfalt der Entwicklertools hat dramatisch zugenommen und reicht von IDEs über Abstraktionen auf höherer Ebene bis hin zu kostenpflichtigen Diensten wie GPT, einschließlich Low-Code-Tools.

Technisches Schreiben ist eine erfolgreiche Marketingstrategie für Entwickler, die auf Authentizität und Verständnis für die Zielgruppe basiert. Startups sollten sowohl online als auch persönlich Zeit mit Entwicklern verbringen, um deren Bedürfnisse und Vorlieben zu erfahren.

Technische Inhalte sollten wirklich hilfreich und lehrreich sein und sind oft effektiver, wenn sie von einem anderen Entwickler erstellt werden. Zu den Optionen gehören interne Ingenieure, Befürworter von Entwicklern, Community-Schreibprogramme, freiberufliche Autoren, unabhängige Software-Ingenieure und Autoren wie ich .

Entwickler sind auf Plattformen wie X (ehemals Twitter), Hacker News, Reddit und LinkedIn präsent und lieben es, gut geschriebene technische Blogbeiträge zu lesen.

Warum zeichnet sich die Strategie für technisches Schreiben aus?

Ich gebe allerdings zu, dass es großen Technologieunternehmen und Start-ups immer besser gelingt, Entwickler zu erreichen. Ich war 13 Jahre lang als praktischer Softwareentwickler und technischer Leiter tätig, bevor ich meinen Blog als Marketingentwickler startete. Hier sind meine Gedanken dazu, warum technisches Schreiben für Start-ups von großem Nutzen ist.

Business-to-Developer-Marketing („B2D-Marketing“) beschreibt Marketinginitiativen, die darauf abzielen, Entwickler zu erreichen . Technisches Schreiben ist eine der besten Möglichkeiten, dies zu tun und dabei authentisch, authentisch und interessant zu sein.

Viele Startups haben Schwierigkeiten mit technischem B2D-Marketing, weil Entwickler schwieriger zu erreichen sind als der Durchschnittsverbraucher. Gimmicks wie Swags, kostenlose Essensgutscheine, kostenlose T-Shirts oder ausschließende Veranstaltungen rund um Alkohol sind nicht der richtige Weg.

Seien Sie interessant – Schreiben ist bei weitem der schnellste Weg, Feedback von Entwicklern in der Softwareentwicklung zu erhalten.

Erstellen Sie ein cooles Projekt mit Ihrem Produkt, schreiben Sie darüber und teilen Sie es öffentlich, um Feedback zu erhalten und es zu wiederholen.

Wir alle Entwickler schätzen Ehrlichkeit. In letzter Zeit hat mir persönlich die Blogseite von Supabase gefallen. Sie haben einige sehr coole Blogs geschrieben und mit ihren geschriebenen Inhalten ein sehr gutes Wachstum erzielt.

Als Startup bedeutet das, dass Sie in der Community ehrlich zu Ihrem Produkt sein sollten.

Viele große Technologieunternehmen stellen Befürworter von Entwicklern ein – jemanden mit technischem Hintergrund, der sein Produkt bei Live-Events vertritt.

Große Technologieunternehmen wie Google/Amazon/Meta/Netflix verfügen über Teams dieser Leute, die auf Konferenzen Vorträge halten, Schulungen durchführen und technische Inhalte über die Produkte ihres Unternehmens schreiben, aber die Rolle des Entwickleranwalts passt für die meisten Startups nicht gut. weil sie schnell handeln müssen und leider viele Entwicklerbefürworter faul und unterdurchschnittlich sind.

Startups brauchen hochqualifizierte Technikingenieure, die schreiben und ihren Technikblog zu einer Plattform machen können, zu der die Leute jede Woche, wenn nicht sogar jeden Tag, kommen möchten.

Startups müssen technisches Schreiben und Dokumentation als Marketinginstrumente nutzen.

Bildnachweis – „State of Developer Relations“ – den vollständigen Bericht finden Sie hier.

Rolle des Technischen Schreibens für eine effektive Kommunikation

Wir können viele verschiedene Arten von technischen Inhalten für Softwareentwickler schreiben.

• Dokumentation ist wichtig, aber nur sehr wenige Startups nutzen Dokumentation als Marketingkanal.
• Tutorials und Anleitungen können Endbenutzern helfen, zu sehen, wie sie Ihr Produkt in der realen Welt verwenden.
• Sensibilisierungsfördernde Inhalte werden mit dem Ziel erstellt, die Spitze Ihres Trichters zu vergrößern, und können zur Erhöhung der Reichweite auf externen Partnerseiten veröffentlicht werden. Hashnode, DevTo, HackerNoon und DZone sind allesamt kostenlose Orte zum Veröffentlichen von Entwicklerinhalten.
• Mit Blogbeiträgen auf Ihrer Website können Sie Leser ansprechen und die Anzahl der Anmeldungen erhöhen.
• Sponsern Sie unabhängige Autoren oder leitende Ingenieure, die einen technischen Blog auf ihrer Website oder in Newslettern schreiben.

Wie technisches Schreiben für Klarheit und Verständnis sorgt

Schreiben Sie immer gute Beispiele, indem Sie mit echtem Code beginnen. Dies schafft Vertrauen bei Kunden und Investoren, während Sie öffentlich schreiben.

Meine Taktik für das Schreiben in der Öffentlichkeit:

Kürzlich fragte mich jemand in meiner Twitter-Direktnachricht: „Hallo Ankur, ich bin ein großer Fan Ihres Blogs, aber ich habe eine Frage: Wie gehen Sie mit dem Schreiben in der Öffentlichkeit um?“ Die Leute im Internet sind manchmal solche Arschlöcher.“

Ich habe oft den Rat gehört „ Entweder schalten Sie die Kommentare aus oder lesen Sie sie nicht “, aber ich habe im Laufe der Jahre, wenn auch manchmal, durch das Lesen von Internetkommentaren zu meinen Beiträgen und den Beiträgen anderer Leute von Fremden eine Menge Wissen gewonnen Die Leute sind Idioten.

Sprechen Sie immer über echte Fakten und seien Sie ehrlich

Ich spreche hauptsächlich über Fakten – entweder Fakten über Startups oder Entwicklerbefürworter über meine Erfahrungen als Autor. Im Allgemeinen würde ich sagen, dass die Kommentare der Leute zu Fakten eher normal bleiben. Die häufigsten Arten negativer Kommentare, die ich zu Fakten über meine Fehler bekomme. Meistens versuche ich, dem entgegenzuwirken, indem ich versuche, mir über meinen Wissensstand zu einem Thema bewusst zu werden, und sage „Ich bin mir nicht sicher…“, wenn ich mir bei etwas nicht sicher bin.

Fehler bearbeiten und umgestalten

Ich mache in meinen Blogbeiträgen viele Fehler, weil ich über viele Dinge schreibe, die am Rande meines Wissens liegen. Wenn Leute auf Fehler hinweisen, bearbeite ich den Blog-Beitrag und korrigiere ihn. Im Allgemeinen bleibe ich einige Stunden in der Nähe eines Computers, nachdem ich einen Blog-Beitrag auf meiner Twitter- oder LinkedIn-Timeline gepostet habe, damit ich auftretende Fehler schnell beheben kann.

Überbrückung der technischen Wissenslücke: Die zentrale Herausforderung im Startup Developer Relations-Programm

Im Umfragebericht wird erwähnt, dass die Inhaltsentwicklung im Jahr 2023 eine Top-Berufstätigkeit für Developer Relations-Praktiker war, wobei zwischen Inhaltsentwicklung im Zusammenhang mit Bildung (55 %) und technischer Inhaltsentwicklung, wie z. B. Dokumentation (50 %), unterschieden wird. Dies unterstreicht die Bedeutung des technischen Schreibens und der Inhaltserstellung für die Interaktion mit und die Aufklärung der Entwicklergemeinschaften.

Die drei wichtigsten Fragen, die sich jedes Startup stellen muss, bevor es einen technischen Blog startet

Das Starten eines technischen Blogs kann für ein Startup ein wichtiger Schritt sein, da es einen durchdachten Ansatz erfordert, um sicherzustellen, dass es seinen beabsichtigten Zweck effektiv erfüllt.

Stellen Sie diese Fragen, wenn Sie einen neuen Blog für Ihr Startup starten.

• der Zweck des Schreibens

• die Zielgruppe

• die Art der zu erstellenden Inhalte

  
  

Es ist von entscheidender Bedeutung, das Ziel des Blogs zu identifizieren, sei es die Steigerung der Markenbekanntheit, die Ergänzung der Dokumentation, der Aufbau eines Publikums oder die Etablierung einer Vordenkerrolle. Zweitens hilft das Verständnis und die Eingrenzung der Zielgruppe dabei, den Inhalt entsprechend anzupassen. Schließlich hilft die Entscheidung über das Inhaltsformat, ob es sich um Tutorials, Zusammenfassungen, Fallstudien, Features, Fragen und Antworten, Vergleiche oder Meinungsbeiträge handelt, dabei, einen konsistenten und ansprechenden Blog zu pflegen.

Das war's für diesen Blog. Ich werde weiter über dieses Thema schreiben und im nächsten Blog mehr Einblicke in spezifischere Funktionen geben.

Bleiben Sie dran. Bis dahin finden Sie hier einige meiner beliebtesten Blogs, die Sie vielleicht gerne lesen würden.

• Softwareentwickler, warum haben Sie noch nicht mit dem technischen Schreiben begonnen?
• So erstellen Sie skalierbare Microservices mit Amplication
• So verwenden Sie benutzerdefinierte HarperDB-Funktionen

Wir freuen uns darauf, im kommenden Beitrag mehr über die Leistungsfähigkeit des technischen Schreibens zu erzählen.