Training_Tutorials
1.0.0
Dieses Repository enthält den Inhalt, der zum Erstellen der Tutorials für .NET -Erste Erstellung von Tutorials auf http://dot.net verwendet wird
Der Inhalt wird nach Themen in hochstufige Gruppen unterteilt, die zunächst abdeckt
In jedem Inhaltsbereich gibt es ein oder mehrere Tutorials .
Jedes Tutorial besteht aus Lektionen . Jede Lektion sollte eine Seite sein, auf der das unterrichtete Konzept zusammen mit dem Beispielcode beschrieben wird. Lektion und Seite können bei der Beschreibung der Tutorials austauschbar verwendet werden. Die Lektionen können in mehrere Schritte unterteilt werden. Jeder Schritt und jede Lektion sollte mit Arbeitscode enden, den der Benutzer mit einem Reply-, Visual Studio- oder Visual Studio -Code ausführen kann.
Sie können den C# -Inhalt als Modell für andere Inhaltsbereiche anzeigen. Beachten Sie, dass URLs/Links 'CSHARP' anstelle von C# verwenden sollten, da GitHub letztere in C%23 umwandelt, was zu kaputten Links führt. Beachten Sie auch, dass Links zu readme.md-Dateien in der Webansicht von Github Fallsensitive sind.
Die Lektionen enthalten Tipps , die nach dem Leserhintergrund markiert werden, und schließlich werden diese Lesern angezeigt, die angegeben haben, dass sie diesen Hintergrund haben. Zum Beispiel:
Tipp {.tip .vb} Das statische Schlüsselwort in C# entspricht dem gemeinsam genutzten Visual Basic .NET.
Die Lektionen enthalten auch Notizen , die bei der Anzeige an die Leser spezielle Formatierung erhalten. Zum Beispiel:
Es ist üblich, Ausnahmen zu protokollieren, die auftreten, damit Sie sie später überprüfen und das Programm verbessern können, um sie nach Möglichkeit zu vermeiden.
Die Lektionen werden unter Verwendung von Markdown (Github -Variante) geschrieben. Die Lektionen sollten mit anderen Dokumenten für bestimmte Aufgaben und API -Referenzen verknüpft werden. Diese sollten sich darauf konzentrieren, dem Benutzer zu helfen, das Tutorial durchzuführen und zu verstehen.
Die letztendlich veröffentlichten Plattformfunktionen und -anforderungen sind noch nicht bekannt. Bis sie sind, haben wir kein System vorhanden, um gemeinsame Elemente über Tutorials/Seiten zu teilen. Im Moment müssen wir kopieren/einfügen.
Der Master -Zweig enthält den neuesten zugelassenen Inhalt. Kurzfristig dürfen genehmigte Inhaltsautoren direkt auf Master drängen. Sobald es eine erhebliche Menge an Inhalten gibt, wird von den Autoren jedoch erwartet, dass sie in ihrer eigenen Feature -Filiale arbeiten, bevor sie eine Pull -Anfrage einreichen und von einem anderen Teammitglied warten.
Wir begrüßen Beiträge und Korrekturen zu diesen Tutorials. Wir werden in Kürze eine Roadmap in den Bereichen bauen, die wir als nächstes ansprechen möchten, aber uns Ihre Ideen senden. Wenn Sie die Schritte beitragen, sind:
Wir bitten darum, dass die Autoren von signifikanten Änderungen die Lizenzvereinbarung der .NET Foundation -Beitragslizenz unterzeichnen. Dieses Projekt hat den vom Mitwirkenden Covenant definierten Verhaltenskodex übernommen, um das erwartete Verhalten in unserer Community zu klären. Weitere Informationen finden Sie im Verhaltenskodex der .Net Foundation.
Dieses Projekt wird von der .NET Foundation unterstützt.
