Skip to content

Latest commit

 

History

History
104 lines (61 loc) · 4 KB

README.md

File metadata and controls

104 lines (61 loc) · 4 KB
Raw

Stride Docs Development

🚀 Getting Started

Welcome to the Stride documentation repository. This repository contains all the source files for the Stride documentation (http://doc.stride3d.net/).

Anyone is welcome to contribute! Before you start, please take the time to read the guidelines.

You can find basic information about editing the documentation in Getting Started dedicated page.

Happy editing!

  • Building 1620 file(s) in ResourceDocumentProcessor(ValidateResourceMetadata)...
  • Building 304 file(s) in ConceptualDocumentProcessor(BuildConceptualDocument=>CountWord=>ValidateConceptualDocumentMetadata)...
  • Building 2133 file(s) in ManagedReferenceDocumentProcessor(BuildManagedReferenceDocument=>SplitClassPageToMemberLevel=>ValidateManagedReferenceDocumentMetadata=>ApplyOverwriteDocumentForMref=>FillReferenceInformation)...
  • Building 6 file(s) in TocDocumentProcessor(BuildTocDocument)...
  • Applying templates to 4063 model(s)...
  • Building 2516 file(s) in ManagedReferenceDocumentProcessor(BuildManagedReferenceDocument=>SplitClassPageToMemberLevel=>ValidateManagedReferenceDocumentMetadata=>ApplyOverwriteDocumentForMref=>FillReferenceInformation)...
  • Applying templates to 4446 model(s)...

Manage multiple Stride versions

Each Stride minor version (i.e. 4.0, 4.1, etc.) should have its own branch, named in the fashion master-<version>. The only exception is latest version, which should be master.

Don't forget to change $version in deploy.ps1 when branching before first deployment.

🤝 Contributing

Use Discord for questions and general discussions. Use Issues to report bugs and proposing features.

We welcome code contributions through pull requests. Issues tagged as help-wanted are good candidates for starting to contribute code.

Branch and Release

The master branch is the default branch for pull requests and most other development activities.

Releases are based on a stable master branch. Use of Conventional Commit is encouraged.

Stride Docs website is not released under a regular cadence; new updates arrive when maintainers fix issues or see enough changes that warrant a new releases. Sometimes we use prereleases to get feedbacks from the community.

🌐 .NET Foundation

This project is supported by the .NET Foundation.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

License

This project is licensed under the MIT License.

Docs

Installation

Prerequisites:

  • Familiarity with the command line
  • Install .NET SDK 6.0 (link) or higher

Make sure you have .NET SDK installed, then open a terminal and enter the following command to install the latest docfx:

dotnet tool install -g docfx

Or check the inslalled version

docfx --version

is at least 2.65.3

Go to stride-docs folder

run

build.bat

Which will rund this command docfx en/docfx.json

http://download.microsoft.com/download/2/E/6/2E61CFA4-993B-4DD4-91DA-3737CD5CD6E3/vcredist_x64.exe