Du hast deinen AdBlocker an?

Es wäre ein Traum, wenn du ihn für t3n.de deaktivierst. Wir zeigen dir gerne, wie das geht. Und natürlich erklären wir dir auch, warum uns das so wichtig ist. Digitales High-five, deine t3n-Redaktion

Entwicklung & Design

Übersichtlich, einfach und hübsch: Mit Readme.io schnell zur fertigen Dokumentation

Readme.io. (Grafik: Readme.io)

Egal ob eine einfache Dokumentation oder eine vollständige Entwickler-Community: Mit Readme.io soll beides schnell und einfach gehen. Wir haben uns den Dienst für euch angeschaut.

Mit Readme.io könnt ihr schnell Online-Dokumentationen erstellen. (Screenshot: Readme.io)
Mit Readme.io könnt ihr schnell Online-Dokumentationen erstellen. (Screenshot: Readme.io)

Mit Readme.io schnell eine zentrale Anlaufstelle für Entwickler schaffen

Gregory Koberger, einer der Gründer von Readme.io, hat schon bei verschiedenen Startups gearbeitet. Dabei will ihm aufgefallen sein, wie viel Zeit bei jeder dieser Unternehmungen für die Erstellung von Dokumentationen und API-Referenzen draufgegangen ist. Wer hier aber Zeit spart, kann Probleme damit bekommen, eine ausreichende Anzahl von Entwicklern von dem eigenen Angebot zu überzeugen. Genau deswegen hat er Readme.io entwickelt.

Dabei handelt es sich um eine Plattform, mit der die Erstellung von Dokumentationen und API-Referenzen enorm vereinfacht werden soll. Readme.io ist als zentrale Anlaufstelle für Entwickler gedacht, die sich mit eurem SDK, eurer API oder eurem Framework vertraut machen wollen. Die Entwickler können sich auch direkt einbringen und über Readme.io Verbesserungen anregen oder direkt Fragen stellen. Wer sich anschauen will, wie Readme.io im Einsatz aussieht, sollte einen Blick auf Mozilla Brick werfen.

Readme.io bietet auch eine Möglichkeit zur Versionsverwaltung. (Screenshot: Readme.io)
Readme.io bietet auch eine Möglichkeit zur Versionsverwaltung. (Screenshot: Readme.io)

Readme.io bietet eine Versionskontrolle und eine GitHub-Integration

Readme.io unterstützt Markup zur Verwendung eurer Dokumentation. Außerdem lassen sich Dokumentationen direkt von GitHub importieren. Dieses Feature konnten wir allerdings nicht testen, da die Funktion aufgrund von Überlastung derzeit deaktiviert ist. Intern nutzt Readme.io eine eigene Versionsverwaltung, mit der sich Dokumente in verschiedenen Stadien verwalten lassen. Neben verschiedenen Templates können Nutzer von Readme.io auch eigene CSS-Themes erstellen sowie eigenen JavaScript-Code einbinden. Das Hosting übernimmt der Anbieter.

In der kostenlosen Version könnt ihr Readme.io zur Erstellung einer einfachen Dokumentation ohne zusätzliche CSS-Anpassungen verwenden. Für derzeit knapp 59 US-Dollar pro Monat könnt ihr eure Seite zusätzlich anpassen, bekommt einen interaktiven API-Explorer und API-Browser, könnt die Landingpage anpassen und Readme.io mit bis zu zehn Administratoren nutzen. Auch der Einsatz einer eigenen Domain ist ab diesem Paket möglich. Firmen zahlen für eine White-Label-Lösung etwa 299 US-Dollar pro Monat und erhalten darüber hinaus die Möglichkeit, eigene Widgets in Readme.io einzubingen.

1 von 9

via news.ycombinator.com

Finde einen Job, den du liebst

Bitte beachte unsere Community-Richtlinien

3 Reaktionen
BastianBalthasarBux

"wie viel Zeit bei jeder dieser Unternehmungen für die Erstellung von Dokumentationen und API-Referenzen draufgegangen ist."

Wohl noch nie was gehört von phpdoc/javadoc/doxygen?

Viel einfacher geht's ja nun wirklich nicht mehr.
Und man hat den Vorteil, dass man die Kontext-abhängige Dokumentation auch gleich im "Intellisense" der IDE hat. Soweit ich weiss wird das Format von allen wichtigen IDEs unterstützt, wie Visual Studio, Eclipse und Derivate, phpStorm, oder meinem ganz besonderen Liebling: KDevelop.

Antworten
Kai

"Readme.io unterstützt Markup zur Verwendung eurer Dokumentation."
> Ihr meint MarkDOWN, oder?

Antworten
Christian Kaps

Read the Docs ist eine gute Alternative. Hat die gleiche Funktionalität wie Readme.io ist aber komplett kostenlos. https://readthedocs.org

Antworten

Melde dich mit deinem t3n-Account an oder fülle die unteren Felder aus.

Abbrechen