mono / website

Mono's web site.

Mono Project Website

This repository contains the files used for generating the Mono website.

The site uses Jekyll, a static site generator. GitHub Pages, where the site is hosted, natively supports Jekyll so every time someone pushes to this repository, the website will be built and updated. For hosting it yourself, see Setting up a local copy of the website.

Contributing to the website

Note: Major issues or feature requests should be filed on the issue tracker first, so we can discuss the implications.

If you want to edit a page, the easiest way is to click the link under the page title on the website.

This will open the source file on GitHub where you can click the pencil button to start editing:

GitHub's editor shows you both the Markdown source as well as a preview of the rendered page:

After you've finished your changes, enter a proper summary and description and click the "Propose file change" button to open a pull request:

Setting up a local copy of the website

For larger changes, using the web-based editor on GitHub is not really convenient. A better way is to setup a local copy of the website where you can experiment.

Dependencies

• Ruby - Jekyll is written in Ruby
• Bundler - a package manager for Ruby. Install it by running gem install bundler

After you've forked and cloned the repository, run the following commands:

1. bundle install - downloads the required libraries
2. bundle exec jekyll serve - builds the website and runs a local webserver on port 4000

Note: you can add the --watch option when running jekyll serve to let Jekyll watch for file changes, which means the site will be rebuilt when a file is modified.

Note 2: on case-insensitive file systems like on Windows and macOS you'll run into redirect loops for some URLs. The workaround is to disable redirects locally by removing the plugins: jekyll-redirect-from entry from _config.yml.

The site should now be running locally:

Repository structure

• _includes - special folder contains snippets that can be included via {% include file.html %} in other pages
• _layouts - special folder contains the layouts that are shared between pages. Layouts can be inherited, the root layout is base.html.
• _posts - special folder, contains the source pages for the blog section, see Writing a blog post
• _site - the output of the generated site is stored here by default, this folder only exists after Jekyll built the site
• archived - content that is no longer relevant but kept to keep external links working
• community - contains the source pages for the /community website section
• css - contains the main stylesheet
• docs - contains the source pages for the /docs website section
• download - contains the source pages for the /download website section
• files - stores binary files used in pages
• images - stores the images used in pages
• news - lists the blog pages from the _posts directory

Writing a blog post

Blogging is very easy with Jekyll. Browse to _posts directory, copy the Markdown file _TEMPLATE.md and rename that file following the file name convention: YEAR-MONTH-DAY-title.md. Then open the file you renamed and follow the steps there to complete writing a blog post.

Make sure to not include special characters in the file name. The blog entry's publishing date is automatically extracted from the file name.

website's Issues

Add robots.txt

Ensure that only the "real" website is crawled, forks should be ignored.
Possibly by checking owner_name == mono from https://help.github.com/articles/repository-metadata-on-github-pages

Link to projects-using-cecil is broken

The Cecil page contains a link to "many other tools" which use Cecil. That link is broken.
If the old page is still archived I would love to see that list somewhere (e.g. part of the mono website).
Otherwise I suggest to remove the link.

Troubles building 32-bit Mono on Windows

We need to review the instructions for Windows because we ran into a bunch of issues trying to build 32-bit Mono on Windows

What are Gaurav utility classes?

This link,
http://www.mono-project.com/community/contributing/the-class-library/
has

.Web
.UI
.Utils // Gaurav utility classes

What are Gaurav utility classes? It is present from the early commits.
Is this the right place to ask things about mono website?

Use of GC.AddMemoryPressure should not be suggested

GC.AddMemoryPressure is a no-op, at least under the SGen garbage collector. The web docs [1] reference this method as a solution to dealing with unmanaged memory, but a first-time Mono user coming from a Microsoft implementation (aka me) will be very surprised to see a normal app run out of unmanaged memory.

Without a large refactoring effort, there is no good solution for existing code that uses relies on the garbage collector in this manner, so I'd suggest an easily noticed warning displayed early on the page.

I'll edit the page myself if others agree this is a valid issue.

[1] https://github.com/mono/website/blob/gh-pages/docs/advanced/pinvoke/index.md#properly-disposing-of-resources

[FAQ] Is there any way how to connect DataAdapter to some Gtk# controls?

I can't found “DbClient” in gtk-sharp/samples.
Perhaps this is old answer.

Suggestion: use port 80 when keyserver.ubuntu.com does not work

Just a suggestion for the index.md page, since I cannot make the edit myself. Perhaps you could add the following text verbatim right after the first block of shell commands in the Debian, Ubuntu, and derivatives section:

Note: If the apt-key command simply stalls, that probably means the default hkp port is blocked. Try the following command instead, which specifies that Port 80 should be used:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

Ubuntu installation instructions don't work

Following the instructions for ubuntu installation yields a long list of 404 errors, so presumably the install instructions need to be updated after some files were moved? Here is an excerpt from the output of sudo apt-get install mono-complete (after adding the GPG signing key and adding the line to my sources)

...
After this operation, 126 MB of additional disk space will be used.
Do you want to continue? [Y/n] Y
Err http://download.mono-project.com/repo/debian/ wheezy/main libmonoboehm-2.0-1 amd64 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-2.0-1 amd64 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmonoboehm-2.0-dev amd64 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-2.0-dev amd64 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-accessibility4.0-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-c5-1.1-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-cecil-private-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-posix4.0-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-system-core4.0-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-codecontracts4.0-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80] Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-cscompmgd0.0-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
Err http://download.mono-project.com/repo/debian/ wheezy/main libmono-csharp4.0c-cil all 4.0.3.20-0xamarin1
404 Not Found [IP: 54.192.15.90 80]
...

The package can also be downloaded directly using the following link:
http://packages.ubuntu.com/trusty/amd64/mono-complete/download
But I cannot install that package because Ubuntu Software Center says:
"Dependency is not satisfiable: mono-runtime (= 3.2.8+dfsg-4ubuntu1.1)"

The direct download link for mono-runtime (http://packages.ubuntu.com/trusty/amd64/mono-runtime/download) opens up in the software center only to tell me "A later version is already installed".

Mac installer .pkg does not make or check for /usr/local/bin/ first

After installing Mono in 10.11.0, it fails to become available on the command line. This is because the directory /usr/local/bin/ does not exist yet on my test machine (and apparently has not existed in a virgin OS X installation since 10.10). The .pkg's postinstall script does not look for or create this directory, so the attempts by the script to use "ln -s" to make the soft links to the Mono framework in /usr/local/bin/ fail silently.

(Previously reported on Bugzilla as bug 33912, and on the Xamarin forum, and on the mono-devel mailing list, but I have gotten no responses in those places.)

404 on Mac install instructions page

As linked from the download page:
http://mono.github.io/docs/getting-started/install/mac

I would suggest a custom 404 page with analytics tracking on the URL and referrer as well :)

Reference MSDN docs for pure CIL C++/CLI assemblies

MSDN has a page for Converting Projects from Mixed Mode to Pure Intermediate Language, which should probably be referenced somehow from docs/about-mono/languages/cplusplus.md

Mention Windows Bash?

Windows 10 recently received Bash. This is made possible through a Ubuntu subsystem, which means commands executed in bash (bash.exe instead of cmd.exe) will run in the Ubuntu context. Since APT is enabled, Mono installation works.

I tested this on Windows 10 Enterprise (non-LTSB), Build 14316.1. These are the commands I used:

Installing Mono

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

Works as expected, no warnings/errors.

sudo sh -c 'echo "deb http://download.mono-project.com/repo/debian wheezy main">>/etc/apt/sources.list.d/mono-xamarin.list;apt-get -qq update;apt-get -qq install git gcc mono-complete'

No warnings / errors. Known issues:

• APT likes to get stuck in Windows Bash (waiting for headers). Rerunning the command will fix this.
• APT complains about systemd et al. This can be safely ignored.

Both these issues are unrelated to Mono and don't have any impact on Mono or it's components as far as I can tell.

Testing

As a trivial test, I compile Turbo from source. This will test Mono, XBuild and mkbundle:

sudo sh -c "git clone http://github.com/turbo/src;cd src;xbuild *.sln /v:q;cp *.dll /usr/lib/;mkbundle -o /usr/bin/turbo *.exe;cd .."

Compiles fine:

XBuild Engine Version 12.0
Mono, Version 4.2.3.0
Copyright (C) 2005-2013 Various Mono authors
/usr/lib/mono/xbuild/12.0/bin/Microsoft.Common.targets:  warning : Reference 'System.ComponentModel.Composition.Registration' not resolved
OS is: Linux
Sources: 1 Auto-dependencies: False
   embedding: /root/src/turbo.exe
Compiling:
as -o temp.o temp.s
cc -ggdb -o /usr/bin/turbo -Wall temp.c `pkg-config --cflags --libs mono-2`  temp.o
Done

Let's run the tests:

root@localhost:~# ls
src
root@localhost:~# turbo src/Tests/tests.js -o ./foobar.exe
Warning in file <src/Tests/tests.js> at (80,6): (TC1187) Variable might be uninitalized.
Warning in file <src/Tests/tests.js> at (407,9): (TC1187) Variable might be uninitalized.
root@localhost:~# mono foobar.exe
> Tests passed: 980/980
> Tests failed: 0/980
> Total time:   309 ms

Splendid. Everything works as one would expect. The only thing that doesn't work (yet) is the binfmt integration, i.e. mono foobar.exe will succeed, but ./foobar.exe will fail. This contradicts the default behavior in Ubuntu, but IMO this is a minor issue.

Adding a hint

My suggestion: Adding a hint somewhere, either on the install page for Windows or Linux that Mono also works in Windows Bash.

Personally, I find this to be quite exciting, as one can now have Mono running both natively on Windows and in the Ubuntu subsystem.

problem in pull request

i have made some changes to /docs/index,md file and unable to send pull request it gives message
"There isn't anything to compare." but i am having changes to file

ECMA reference broken

http://www.mono-project.com/docs/about-mono/languages/ecma/

TR-89: CLI Technical Report – Additional Generics Library (pdf)

The TR-89 is broken, the file doesn't exist.

Aslo the other links link to outdated files. Shouldn't we directly link to ECMA?

Migrate doc candidate pages to new layout

... and cleanup/update them while doing that

Need to mention installation of pkg-config

pkg-config is also needed when working via ./configure && make process, as opposed to the brew install method.

Otherwise one ends up with `/usr/local/share/aclocal/pkg.m4’ missing.

(Reported on #mono IRC by @dwarfland)

update link to pythonnet

http://www.mono-project.com/docs/about-mono/languages/

http://pythonnet.github.io/

Installation instructions do not work for Debian 8

Hi,

Just tried to install mono-complete on my Debian 8 system.

I followed the instructions from this page:
https://github.com/mono/website/blob/gh-pages/docs/getting-started/install/linux/index.md

After adding the key and the mono-xamarin.list file, every attempt to apt-get install mono-complete would fail because apt couldn't find the dependencies.

I removed the mono-xamarin.list file, apt-get update and it all worked properly.
Not sure if the key is needed though (which is why I didn't make a pull request).

Look up dates for older Mono releases

Some of the Mono releases in https://github.com/mono/website/blob/gh-pages/docs/about-mono/releases/index.md miss the release dates.

Resizing the page to "medium" size breaks header

Might be fixed by switching to editing the Foundation SCSS instead of overriding the CSS (depends on #1 for SCSS processing).

Mono.framework error --> Unsealed contents present in the root directory of an embedded framework In subcomponent: /ABC.app/Contents/Frameworks/Mono.framework".

1. We use Mono.framework being embedded into your "ABC.app".
2. We package "ABC.app" and sign it with Apple certificate. While signing the ABC.app using the command [codesign -f -s "Intuit" --deep "ABC.app"]
3. We are getting the following error "ABC.app: unsealed contents present in the root directory of an embedded framework In subcomponent: /ABC.app/Contents/Frameworks/Mono.framework".

Please note this has become an blocker for us to launch the application into production, it would be great if Xamarin can look into this to provide some resolution.

Also when we try code signing just the framework, it builds fine "codesign --verbose --force --sign "$IDENTITY" "$LOCATION/Mono.framework/Versions/Current"", but when we try to sign the whole application we are running into above issue.

Please let me know if more information is required.

Mono framework version: 2.10.9

Thanks,
Sanketh Bhat
Intuit Inc
Bangalore
[email protected]
[phone]

Crawler for broken markdown

We should get a page crawler in place to check for broken markdown. Found one instance in http://www.mono-project.com/docs/advanced/com-interop/

GTK# 2.12.25 download link when 2.12.26 is available

The mono-project.com website offers GTK# 2.12.26 as a download whilst the monodevelop.com website offers GTK# 2.12.25.

The monodevelop website should have a download to GTK# 2.12.26 since that is the current version that Xamarin Studio installs with its universal installer.

mono-project.com: http://download.xamarin.com/GTKforWindows/Windows/gtk-sharp-2.12.26.msi
monodevelop.com: http://download.xamarin.com/GTKforWindows/Windows/gtk-sharp-2.12.25.msi

License for sample code

Does the CC-BY-SA license also apply to the sample code on the website? Reference: KSP-CKAN/CKAN#1832 (comment)

Root inside Location block

I'm just a noob in the mono/nginx world - but this site [https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/] says its a mistake to include the root statement inside the location block as shown in http://www.mono-project.com/docs/web/fastcgi/nginx/
Perhaps someone who isn't a noob should review it.

Mono.Cecil release notes missing

The page below has the line:

Here are the release notes for every version of Cecil

followed by a list of versions, but no links. Are there any release notes online? I couldn't find them anywhere - either way, either the text, or the links should probably be changed. 😄

https://github.com/mono/website/blob/gh-pages/docs/tools+libraries/libraries/Mono.Cecil/index.md#release-notes

Upgrade to Jekyll 2.0

Depends on github/pages-gem#63

Evaluate references to old/archived pages

These pages are referenced in the new documentation structure, but I don't think they add enough value to justify migrating them. Most of them will likely stay archived, so we should see if we still need links to them in the new documentation.

(The main item is the archived page, the sub-item(s) are where the page is referenced from)

• Accessibility
  • index
  • plans
  • irc
• ADOTests
  • adonet
• Article:ThreadPool_Deadlocks
  • mod_mono
  • technical
• Articles
  • index
• ASP.NET_Modules
  • aspnet
• ASP.NET_Mono_Specific_Configuration
  • aspnet
• ASP.NET_Settings_Mapping
  • aspnet
  • aspnet
• ASP.NET_Visual_Designer
  • aspnet
  • plans
• ASPTests
  • aspnet
• BaseClass_Provider_Factory
  • adonet
• Benchmark_Regressions
  • benchmark-suite
• Best_Practices
  • gtk
• Books
  • index
  • index
• CGI
  • aspnet
  • aspnet
  • index
  • aspnet
• Config
  • aspnet
• Config_system.web
  • aspnet
  • aspnet
• Consuming_a_WebService
  • index
• Continuations
  • plans
  • runtime-projects
  • runtime-projects
  • index
• Crimson
  • plans
  • security
• Cryptography
  • plans
  • technical
  • technical
• DB4O
  • index
  • index
  • index
• Dead_Toolkits
  • gui-toolkits
  • index
• EnterpriseServices
  • plans
  • technical
• Gcc4cil
  • index
  • index
• GConfTutorial
  • tutorials
  • details
• GeckoSharp
  • plans
• Generating_class_status_pages
  • class-status
• GettingStartedWithMonoTools
  • plans
• GtkGLArea
  • gapi
  • details
• GtkGLAreaSharp
  • details
  • plans
  • index
• Guide:Debugger
  • technical
  • technical
• HeapBuddy
  • index
  • technical
• Howto
  • index
• Howto_OpenBrowser
  • technical
• ImprovingGtkWin32
  • ideas
• ImprovingModMono
  • mod_mono
• InfrastructureProjects
  • plans
• Internationalization
  • tutorials
  • details
• Introduction_to_Deveel_AJAX
  • index
• Introduction_to_Mono.Addins
  • index
• JScript
  • index
  • plans
• Mailpost:earlystory
  • history
• Mailpost:longreply
  • history
• MaxDB
  • index
• Mimer_SQL
  • index
• Monkeyguide
  • index
  • index
  • general
• Mono.Addins
  • mailing-lists
• Mono_DataConvert
  • 2.2.0
  • index
• Mono_Documentation_Improvement_Project
  • index
• Mono_Performance_Counters
  • technical
• Mono_Runtime_API_Changes
  • runtime-projects
  • index
• MonoCurses
  • index
• MonoDevelop
  • mailing-lists
• MonoMacPackager
  • monomac
• MonoTorrent
  • index
• Monoxide
  • index
• NAnt_Installation
  • software
• ObjCSharp
  • osx
• Old_Visual_Basic
  • visualbasic
• OLE_DB
  • index
  • technical
• Olive
  • wpf
  • roadmap
  • plans
  • 2.6.3
  • 2.6.4
  • 2.6.0
  • 2.6.7
  • 2.6.1
  • mailing-lists
• OprofileWithAnonJitData
  • performance-tips
• OptimizingAOT
  • index
  • aot
• Pango:Beginners
  • tutorials
  • details
• Papers
  • index
• PerformanceTesting
  • technical
• Porting_MSBuild_Projects_To_XBuild
  • xbuild
• Provider_Factory
  • adonet
  • technical
• Python
  • index
  • plans
• Related_Mono_Sites
  • index
• Resources
  • index
  • index
  • the-class-library
• Roadmap_History
  • roadmap
• SecurityValidation
  • sandbox
  • sandbox
  • coreclr-howto
• Stetic
  • details
  • plans
• Summer2005
  • cplusplus
  • index
  • previous-years
• Summer2006
  • index
  • linker
  • previous-years
• Summer2007
  • previous-years
• System.Messaging
  • plans
  • technical
• System.Query
  • plans
• Tao
  • general
  • plans
• TDS_Generic
  • index
• ThreadsBeginnersGuide
  • responsive-applications
• Todo
  • index
• Transactions
  • technical
  • plans
• UI_Automation
  • plans
  • irc
• User_Groups
  • index
• UsingTrustedRootsRespectfully
  • security
• Videos
  • index
• Visual_Studio_Integration
  • plans
• WCF_WSHttpBindingHacking
  • wcf
• WCFStatusOld
  • wcf
• Web_Services
  • aspnet
• Webservices_and_GtkSharp
  • tutorials
  • details
• WebStandards
  • aspnet
• WinForms_Designer
  • index
  • plans
• Winforms_Samples
  • index
• Working_with_Mono_and_Visual_Studio
  • installer-for-net-framework
  • index
• Writing_a_WebService
  • index
• Writing_Connected_Mode_Testcases
  • adonet
• WSE
  • roadmap
  • plans
  • aspnet

Need an update for tlstest compilation in security FAQ?

The page https://github.com/mono/website/blob/gh-pages/docs/faq/security.md explains how to compile and use tlstest.exe. When I follow these instructions and run mcs tlstest.cs /r:System.dll /r:Mono.Security.dll I get following output:

mcs tlstest.cs /r:System.dll /r:Mono.Security.dll
tlstest.cs(169,23): warning CS0618: `System.Net.ServicePointManager.CertificatePolicy' is obsolete: `Use ServerCertificateValidationCallback instead'
tlstest.cs(172,23): error CS0117: `System.Net.ServicePointManager' does not contain a definition for `ClientCipherSuitesCallback'
/usr/lib/mono/4.5/System.dll (Location of the symbol related to previous error)
tlstest.cs(210,26): warning CS0618: `System.Net.Dns.Resolve(string)' is obsolete: `Use GetHostEntry instead'
Compilation failed: 1 error(s), 2 warnings

Is is possible that this FAQ session is outdated?

Examine site footer

What do we really need to put there?

Broken link on http://mono-framework.com/Languages

DotNetPowered.com link (http://www.dotnetpowered.com/languages.aspx) on http://mono-framework.com/Languages is broken.

How current is MoMa?

Is the mono migration analyzer current with mono-4.4.0.182.tar.bz2 ? I need to use Microsoft's Open-XML-SDK on Linux, probably with mono. When I posted that MoMa reported 34 issues, one reply said that MoMa wasn't up to date when he checked.
dotnet/Open-XML-SDK#100

• HowardRubin

Cross Compiling Mono for Windows is Out of Date

The "Cross Compiling Mono for Windows" page is horribly out of date.
I would like to update it. Either with a new valid way of accomplishing that goal. Or with a notice that warns readers about it no longer being viable.
Does anyone have any thoughts or input on this?

Page
File

Add Google Analytics

grab info from the old site

Write readme and short intro

Should contain overview of repo structure, how you add a blogpost etc.

MoMA description page needs a note

I looked around for a while to see if MoMA was something I should run on my Windows machine before I try to port the program to Linux, or something I should run on my Linux machine.
In the end, I downloaded it and it looked like something I should run on Windows, so I tried that and it worked.
It would help users if you could add something to the Moma description page such as
Run Moma on your Windows machine.

Thanks for listening,
Jim

Log Profiler Documentation

Maybe I'm blind.

But I can't find documentation how to e.g find memory or thread bottlenecks using mprof-report. So I wish somebody with the knowledge writes short beginner tutorial or adds link to existing one.

Any pointers to solving mono 4.6.1 CPU usage are welcome though. Running with v3.12.1 works fine.

Thank You.

El Capitan

Don't know if it is deliberate, but there is no link to the 4.0.4.4 for El Capitan version mentioned at the top of the Mac Download page.

The second link on the page takes you to downloading 4.2.0

Letter from Microsoft to ECMA link is a 404

Did some poking around in the Old Background Section of the License FAQ and noticed the link pointing to the pdf of Microsoft's letter to ECMA is a 404. I went digging for it with a little googling but couldn't find a replacement or new link.

Missing images in GtkSharp tutorials

All of the Gtk# tutorial pages seem to be missing their photos. The raw markup is displayed instead.
Example from GtkSharp: Packing with Tables

Instead of a png,

[Image:tables.png]

Is displayed.

(I am running Google chrome on windows 7)

Runtime Projects page looks outdated

http://www.mono-project.com/docs/advanced/runtime/runtime-projects/

I think most of the stuff on that page was completed. We should probably move the page to /archived (as I don't think new work will be tracked there).

Issues with jekyll serve on case-insensitive file systems

When you use jekyll serve on case-insensitive file systems some of the redirects act up, e.g. on the download page which has redirect_from: /Download/. This results in a redirect loop as the redirect points to itself.

Add fallback to PNG if SVG is not supported

http://callmenick.com/2014/04/02/svg-fallback-with-png/

MonoMac documentation directs to expired domain: http://cocoa-mono.org/

Documentation of MonoMac (GitHub page) links direct to the domain http://cocoa-mono.org/ which expired on December 31, 2014.

This includes many of the links under the Tutorials sections:

Tutorials

• Online blogs/tutorials:
• Getting Started Part 1
• Getting Started Part 2
• Using KVC and KVO with MonoMac
• .NET Timer vs NSTimer on MonoMac
• Using the Animator Proxy
• Using Growl with MonoMac
• Adding an Application Icon to your MonoMac app

Add CNAME

so the website can be hosted on GitHub pages.

https://help.github.com/articles/setting-up-a-custom-domain-with-github-pages

Add TOC to doc pages

Using http://gregfranko.com/jquery.tocify.js

CoreOS is using it and I like how it works: http://coreos.com/docs/running-coreos/cloud-providers/ec2

Step 6: Adding Events, links broken

Hi,

just to let you know that the links under Step 6: Adding Events are broken unfortunately. Otherwise, very interesting information.

Thanks

Gilles Plante

CentOS 6 installation instructions

CentOS installation section tells to run command
yum-config-manager --add-repo http://download.mono-project.com/repo/centos/

Unfortunately for CentOS 6 this repository gives library dependencies errors when trying to install mono.

In order to fix this I used
yum-config-manager --add-repo http://download.mono-project.com/repo/centos6/

After which I was able to install mono successfully on CentOS 6.

Can you please adjust the installation instructions on http://www.mono-project.com/docs/getting-started/install/linux/
and state there a correction for CentOS 6, this will save a lot of time for people.

Missing link to widgets

The file https://github.com/mono/website/blob/gh-pages/docs/gui/gtksharp/widgets/index.md does not provide links to the various widget md files in the same folder. However, you can reach this index file via the "breadcrumbs"

You are here: DOCS / GUI / GTKSHARP / WIDGETS

The index file one level higher up (https://github.com/mono/website/blob/gh-pages/docs/gui/gtksharp/index.md) links to the widget md files.

rule-links broken

Hi there!

The rule-links in the readme are broken, on the gendarme index (https://github.com/mono/website/blob/gh-pages/docs/tools+libraries/tools/gendarme/index.md).