All Projects → mono → api-doc-tools

mono / api-doc-tools

Licence: MIT License
.NET Reference API Toolchain

Programming Languages

C#
18002 projects
HTML
75241 projects
XSLT
1337 projects
F#
602 projects
C++
36643 projects - #6 most used programming language
Makefile
30231 projects

Projects that are alternatives of or similar to api-doc-tools

UniversalUnityHooks
A framework designed to hook into and modify methods in unity games via dlls
Stars: ✭ 78 (+34.48%)
Mutual labels:  mono
epicedit
Epic Edit, Track Editor for Super Mario Kart (SNES)
Stars: ✭ 30 (-48.28%)
Mutual labels:  mono
AppRopio.Mobile
AppRopio - mobile apps builder for iOS/Android based on Xamarin
Stars: ✭ 16 (-72.41%)
Mutual labels:  mono
Nancy
Lightweight, low-ceremony, framework for building HTTP based services on .Net and Mono
Stars: ✭ 7,170 (+12262.07%)
Mutual labels:  mono
PureScript
A C# hot reload framework for Unity3D, based on Mono's MONO_AOT_MODE_INTERP mode.
Stars: ✭ 258 (+344.83%)
Mutual labels:  mono
MonoSerialPort
Serial port library for .Net / Mono, that can be used with virtual usb port
Stars: ✭ 42 (-27.59%)
Mutual labels:  mono
Portable-WebDAV-Library
Moved to codeberg.org - https://codeberg.org/DecaTec/Portable-WebDAV-Library - The Portable WebDAV Library is a strongly typed, async WebDAV client library which is fully compliant to RFC 4918, RFC 4331 and "Additional WebDAV Collection Properties". It is implemented as .NETStandard 1.1 library in oder to be used on any platform supporting .NETS…
Stars: ✭ 45 (-22.41%)
Mutual labels:  mono
Xake
Another MAKE utility implementation on F#, fully declarative with no-brain parallelism, inspired by Shake
Stars: ✭ 24 (-58.62%)
Mutual labels:  mono
Mono.Cecil.Inject
An extension to Mono.Cecil that provides helper methods for simple method injection.
Stars: ✭ 65 (+12.07%)
Mutual labels:  mono
mono-reactive
open source Reactive Extensions (Rx) implementation for Mono
Stars: ✭ 65 (+12.07%)
Mutual labels:  mono
gauge-csharp
Csharp runner for Gauge
Stars: ✭ 34 (-41.38%)
Mutual labels:  mono
Paket.Unity3D
An extension for the Paket dependency manager that enables the integration of NuGet dependencies into Unity3D projects.
Stars: ✭ 42 (-27.59%)
Mutual labels:  mono
ManDrake
Native Mac man page editor with syntax coloring, mandoc syntax checking & live preview.
Stars: ✭ 130 (+124.14%)
Mutual labels:  mdoc
rdfshape-api
API for validating and transforming RDF, ShEx, SHACL and more.
Stars: ✭ 31 (-46.55%)
Mutual labels:  mdoc
ng-mono-repo-starter
Angular Mono Repo Starter
Stars: ✭ 79 (+36.21%)
Mutual labels:  mono
MonoAGS
AGS (Adventure Game Studio) reimagined in Mono
Stars: ✭ 26 (-55.17%)
Mutual labels:  mono
PCLExt.FileStorage
Portable Storage APIs
Stars: ✭ 35 (-39.66%)
Mutual labels:  mono
XnaToFna
Relink games / tools using the XNA Framework 4.0 to use FNA instead
Stars: ✭ 40 (-31.03%)
Mutual labels:  mono
codewriting
Source for Codewriting (book) and the Codewriting/Code the Docs (site/blog)
Stars: ✭ 49 (-15.52%)
Mutual labels:  documentation-toolchain
Uno.Wasm.Bootstrap
A simple nuget package to run C# code in a WASM-compatible browser
Stars: ✭ 242 (+317.24%)
Mutual labels:  mono

mdoc

This repository contains the source for the .NET API Reference toolchain (used by docs.microsoft.com)

Contribution Guide

You can read the contribution guide for information about coding standards, and (perhaps most importantly), information about writing unit and integration tests.

Compiling

Dependencies

This repository uses submodules, so firstly, you have several options:

  • You can include all submodules when you initially clone: git clone --recursive https://github.com/mono/api-doc-tools.git
  • If you already have it local, you can use git submodule update --init --recursive
  • If you have all CLI dependencies (see below), you can make prepare

Visual Studio

On windows, you can build and compile apidoctools.sln. And you can run unit tests if you have NUnit installed. If you use Visual Studio for Mac, you can use its built-in support for NUnit tests to also run tests.

CLI

If you've got make and mono installed, you can run make prepare all check in a bash prompt to do a release build and run the full test suite (which for mdoc includes more than just the nunit tests). The available targets are:

  • prepare: initializes the submodules, and restores the nuget dependency of NUnit
  • all: compiles everything
  • check: runs unit tests for monodoc and mdoc
  • check-mdoc: runs only mdoc tests
  • check-monodoc: runs only monodoc tests

You can also control some parameters from the command line:

If you want to compile in debug mode: make all CONFIGURATION=Debug

If you are using WSL, use: make all ENVIRONMENT=wsl

Feel free to open a pull request early in order to make it easy to ask questions during development, and for the maintainers to offer feedback.

Troubleshooting

Forcing Changes

When you make certain kinds of changes, it can confuse Make's dependency ... if you're running the test suite and it doesn't seem to be reflecting your changes, add the -B parameter to the make invocation, and it will force a rebuild of all targets.

WSL

Make sure you are at least on 16.04 (Xenial). You can check which version is currently installed by running the command lsb_release -a.

If you are running an older version (for example, if you originally installed WSL before the creator's update) and need to upgrade, you can run the following commands:

  • sudo do-release-upgrade ... this updates the version of Ubuntu. Please note, this will likely disable any external package sources, such as the one added when installing Mono.
  • Once you're done with that, then you just need to update apt-get
  • Steps to set up the local WSL mdoc environment
    • Install make sudo apt-get install make
    • Install mono, Add back Mono's package repository source, as described in the download instructions.
    • Install Nuget sudo apt-get install nuget
    • Install F# Compiler sudo apt-get install mono-complete fsharp

With that run ... you should be able to run the build locally using make prepare all check.

Linux

The following script will prepare, clone, and run a full build with tests of mdoc on an unbuntu docker container.

apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF  
echo "deb http://download.mono-project.com/repo/ubuntu trusty main" | tee /etc/apt/sources.list.d/mono-official.list

apt-get update
apt-get install tzdata nuget -y --allow-unauthenticated
apt-get install git make mono-devel mono-vbnc ca-certificates-mono wget fsharp -y

wget -q 'http://mxr.mozilla.org/seamonkey/source/security/nss/lib/ckfw/builtins/certdata.txt?raw=1' -O "/tmp/certdata.txt" 
mozroots --import --ask-remove --file /tmp/certdata.txt


git clone https://github.com/mono/api-doc-tools
cd api-doc-tools
make prepare all check

Please review mono's installation guide if you are using a different flavor of linux.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].