Bis wir eine native Möglichkeit zur Handhabung lokalisierter Dokumente haben, denke ich, dass das Voranstellen von Flaggen dem Titel die praktischste Methode ist und eine vernünftige Ausnahme von dieser Richtlinie darstellt.
Ich denke, diese Art von Dingen hat unterschiedliche Meinungen und Vorlieben, aber für diesen Styleguide orientieren wir uns an den akzeptierten Branchennormen. Wieder einmal stimmen die Richtlinien von Google und Microsoft darin überein, dass gebräuchliche Kontraktionen besser zu verwenden sind.
Davon abgesehen habe ich einige Beiträge gelesen, die darauf hindeuten, dass die Verwendung von negativen Kontraktionen (wie “kann nicht”) das Verständnis für Nicht-Englischsprachige erschweren könnte. Wir werden uns das noch genauer ansehen und, falls nötig, den Styleguide entsprechend aktualisieren.
Ich habe dieses Beispiel entfernt! ![]()
Ja – das ist sehr üblich (nicht nur bei Discourse), aber ich stimme zu, dass es nicht ganz korrekt ist. Die Verwendung von Anführungszeichen wäre besser, daher werde ich das im Styleguide explizit machen.
Das ist ein wichtiger Punkt – ich werde das in den Styleguide aufnehmen!
So sehr ich es schätze, nicht mehr eine Tonne von Dokumentationsthemen, die mir zugeschrieben werden, zu haben, fühlt es sich ein wenig kalt an, Discourse als Autor aller Dokumentationsthemen des Teams zu verwenden.
Vielen Dank für dieses Feedback! @maiki hat oben einige gute Punkte angesprochen, und ich stimme dem zu, was er dort sagt. Ich möchte noch hinzufügen, dass einer der Gründe, warum wir die offiziellen Dokumentationen auf @Discourse als Autor umgestellt haben, darin besteht, ihnen für die Leser, insbesondere für Personen, die die Dokumentationen zum ersten Mal lesen, ein größeres Gefühl der Autorität zu verleihen. Dies ist auch der Anstoß für den gesamten Styleguide.
Jeder, der Dokumentationen schreibt, kann seine Persönlichkeit definitiv weiterhin in seine Texte einbringen, und die Diskussion über einzelne Dokumentationsthemen wird nicht verschwinden, sodass dies immer ein guter Ort ist, um Dinge persönlicher zu gestalten.
All dieses Feedback wird sehr geschätzt ![]()