What's the problem?
Our tutorials section the way it currently is, is a wild chaos, tutroials are written without reference to each other, they use terms that were never explained and the just is nopoint zero from where to start. This doesn't effect us directly since we already know most stuff, but new users will just nd up getting confused, so theiy either give up or open topics or send us PMs so we can answer the same questions over and over again.
Needless to say this is bad for both sides.
The tutorials section needs to become like a library instead a bunch of loose papers. This means the following:
- redo the categories, more and clearer catagoeries
- common layout template and quality standards so that after reading one tutorial the reader knows how the rest work. We already have common templates for the website and the port database, this is important as well.
- some tutorials that only explain things instead of showing how to do stuff, so these can be referenced in how to... tutorials.
The first step
The first step is to agree on the most important categories and topics we will need, as well as the layout template. USers will be able to pick a topic and once we have enough writers we can start revamping the tutorials section. I don't think we should always have to annouce what we write about, but for now it is necessary to prevent everything going back to chaos.
Currently we have five categories. Here is my idea of what we whould have:
- About the Porting Team: tutorials only dedicated to this website, how to post stuff, how to find stuff, that wort of thing
- Reference: What is Wine, what's the difference between Wine and Corossover and Cider, what's a wrapper, what's a command line application, what's a self-extracting archive? That sort of stuff. These tutorials should be about letting the user understand what they are about to do, not how to do it. Thes tutorials can then reference other how-to tutorials and they can be referenced.
- Wineskin tutorials: Now we gt to the meat, everything Wineskin-related should go here. Using Wineskin's advanced tools, Registry editing, Winetricks, that sort of stuff.
- CiderX tutorials: Same thing as above, except for Cider. If there are procedures that are similar for both, then they should still be separate tutorials since they are not exaclty the same
- Misc. tutorials: for anything else that is not directly porting related but still fits here, like making fancy DMGs
I will post a few topic suggestions for each category later and then we need to agree on a common layout and guidelines. Please feel free to share your opinions, this is just a suggestion by me.