This repository contains (or will contain) complete examples for various popular projects like:

• [ DllExport ]; [ Conari ]; [ GetNuTool ]; [ vsSolutionBuildEvent ]; [ MvsSln ]; [ regXwild ]; [ hMSBuild ]; ...

Also may contain complete examples for some programming languages, frameworks, platforms, ...

It continues idea from: 3F/DllExport#84

And complements the old :: .sandbox. ::

• To download all examples: https://github.com/3F/Examples/archive/master.zip
• To clone repository: git clone https://github.com/3F/Examples.git

But if you need only one, try for svn export, or git + --depth=1 + sparseCheckout filter, and so on.

Or please use ghdir scripts:

• ghdir For Linux & Windows: https://github.com/3F/sandbox/tree/master/shell/ghdir

ghdir {url_to_directory} [{optional_destination_path}]

Sample for DllExport/BasicExport:

ghdir https://github.com/3F/Examples/tree/master/DllExport/BasicExport

Receives only this:

└───Examples
    └───DllExport
        └───BasicExport
            ├───ClassLibrary1
            │   └───Properties
            ├───ClassLibrary2
            │   └───My Project
            └───UnmanagedCppConsole

Through complete examples, this repository will provide more actual support and some solutions for open projects, or more.

Additional repository like https://github.com/3F/Examples is less associated to specific license! It just provides more transparent layer in the legal field between each example instead of already used repositories.

Moreover, some specific examples may provide more additional artefacts, unit-tests, and lot of other things that are directly related only to examples and not for their projects.

Feel more free, and/or make your contribution according to your specific rules.

As was stated above, some contributors may provide custom license for each example separately. You should find any related license file inside directory with example.

However, it will be the MIT License (MIT) by default if directory with examples does not provide anything else.

Copyright (c) Authors and contributors of each individual example

1. Root directory contains folders that are related to specific projects by their names. For example:

[3F/Examples]
    \DllExport
    \Conari
    \MvsSln

2. Some special examples are stored inside common root directory (named as -). This folder will aggregate examples by their types and related subtype, for example:

[3F/Examples]
    \-\lang\CSharp
    \-\lang\CPP
    \-\frameworks\<subtype1>
    \-\platforms\<subtype1>
    \-\<type4>\<subtype1>
    \-\<type4>\<subtype2>
    ...

Please note:

• Each root directory should provide Readme file to specify at least information about what is it (url of the project home page and so on).
• *lang means programming language

The name shouldn't contain any whitespace characters. Use Pascal case, or underscore _ characters, or dot . characters instead if you're contributing something. For example:

• Without_Whitespace_Name
• WithoutWhitespaceName
• Namespace.For.Everyting

Unspecified format. However, each root example should provide at least Readme file.

Inside each directory with example (its root folder) should be presented the Readme file. It should describe something about placed example, and some additional related information.

If you're contributing something, please follow this rule to provide at least short description and some accompanying notes for your example. Name it as Readme.md file because it will allow to use markdown syntax inside.

The License file is optional for each example. That is, an example is licensed under default MIT License if any License file does not exist at all.

But, again, you can optionaly also specify your custom license and copyright for your example if you're contributing this to us.

1. Place your files of the new example in relevant folder under structure.
2. Please specifiy Readme file to provide at least short description about your example.
   • The Readme.md name is recomended because of support the markdown syntax inside.
3. License file is optional if you want to use our default license.
4. Use PR (pull requests) to push your example on https://github.com/3F/Examples.

We're waiting your awesome examples like for beginners and for professionals.