I have done further research on the use of Open Source tools to create a documentation site. The last one I tested was a Wiki still in popular use, Screw Turn Wiki. However, like the previous tools I have tinkered with, this too had compile issues.
As a software engineer, my standard when using such software has always been that if it doesn't work correctly right out of the box, it is not worth your time trying to figure out the issues.
I know it has been suggested that we use the current documentation page within the MonoGame web site. However, doing so does not provide any guide as to how we may want to design the presentation of a full site to support good documentation for MonoGame.
For example, we would want to set up the following sections at the very least...
- Basic Tutorials
- Advanced Tutorials
- FAQ by Category
- Third Party Articles
- Third Party Sites
- Code Snippet Repository (compressed in zip-file format)
- Project Repository (for those who want to contribute their projects / compressed in zip-file format)
This is tall order but one I believe can encompass everything people would require to do their research in a single place.
Since, the MonoGame Documentation Page has been rather poorly maintained, if we can get this up and running, the developers at MonoGame may want to consider simply putting a "redirect" on their documentation page to this new site, which the entire community could then easily support.
Though I had been hoping that we could use Open Source software to quickly develop a basic system, it does not appear with what is available that this will be feasible. As a result, maybe we should consider the following factors for those who may be interested in pursuing such an endeavor.
We write our own Wiki-like system from scratch using ASP.NET WebForms (which is much faster to develop with and just as powerful as the MVC option).
Visual Studio Community Edition is an extremely powerful IDE (the latest is VS 2017, though I still prefer using VS 2015). VS Community Edition provides just about all the features of the Professional Edition for which I had a professional MSDN subscription license for many years; so I know the differences.
If we require a third-party suite of tools, Syncfusion also has a Community Edition which provides the entire line of all its platform tools absolutely free to developers. They are as good as any other tool suite so if needed, we can take advantage of it.
For a database I recommend either SQL Server or MySQL since both are commonly supported on hosting sites (I recommend WinHost for their excellent services and developer friendly infrastructure.).
To begin with, I have been researching database designs that could support such a project. It will provide enough information to get an idea as to how we should proceed with an interface....