   I hate bad written articles/tutorials
  I'm doing research on .NET remoting, and I'm googling around to get as much articles on the subject as I can get.I came around this article:http://www.c-sharpcorner.com/Internet/remoting_chat_server2.aspAt first, it looked OK, until I read further. The article itself explains NOTHING on the subject itself. It explains what some technical terms are, and then continues to tell I need to look at the example code.Well, the example code is badly written and totally uncommented. In other words, using the MSDN I would have learnt more than using this article. Lemme show some example code:   /// <summary>    ///    Summary description for ServerTalker.    /// </summary>    /// Threading public class ServerTalker  {private ObjectList messages = new ObjectList();private ChatServerImpl cs;private Thread t=null;public ServerTalker(ChatServerImpl cs, String name) {this.cs = cs;//Send a welcome messagemessages.Add(new    Message("***", name + " just connected***"));t=new Thread(new ThreadStart(this.run));t.Start();}This excellent piece of code explains nothing. I don't have the need to dig through 7 files thoroughly to find out how this application works. Thank God GDNet doesn't have articles like this, because these articles are a waste of my 10 minutes.Toolmaker   
Quote:Original post by ToolmakerAt first, it looked OK, until I read further. The article itself explains NOTHING on the subject itself. It explains what some technical terms are, and then continues to tell I need to look at the example code.Well, the example code is badly written and totally uncommented. In other words, using the MSDN I would have learnt more than using this article. Lemme show some example code:Agreed. It's generally best to avoid programming tutorials found with google unless they're coming from a reputable source. Any idiot (often well meaning) can put a bad tutorial on the net.Quote:Thank God GDNet doesn't have articles like this, because these articles are a waste of my 10 minutes.My understanding is that GDNet articles are submitted to the site and must be approved by a staff member or mod before they can be viewed - which helps keep a lot of the crap out. Plus there's a forum here for discussing articles which can quickly point out any errors.   ;Quote:Original post by Will FMy understanding is that GDNet articles are submitted to the site and must be approved by a staff member or mod before they can be viewed - which helps keep a lot of the crap out. Plus there's a forum here for discussing articles which can quickly point out any errors.We have an Editorial Review Board which reviews all submitted material before it can be accepted to the site.   ;  It's one case where being told to Google for something isn't so useful. Every newb seems to have written an article on initialising D3D - and every now and then I come across posts where someone has no idea how do do something; as soon as they get some help they say "now I can write a tutorial on this"!GD's articles are always good as I remember. I just wish they were more frequently added.   ;  I hate badly written thread titles.  [grin]   ;  You're right, the tutorial is sloppy. But the code is readable, and a short description of the overall structure would be enough to make it completely understandable:  /// <summary>  ///    A decorator for a ChatServerImpl implementation,  ///    synchronizes a list of messages over the network.  /// </summary>  public class ServerTalker    {    // The list of all messages that were seen (sent,// received) by this Talker    private ObjectList messages = new ObjectList();    // The chat server on which this Talker depends    // for message sending and receiving.    private ChatServerImpl cs;    // Internally, the server talker uses a different    // thread in order to be able to perform message    // sending and receiving asynchronously.    private Thread t=null;    // Connects the user 'name' to the server 'cs'    public ServerTalker(ChatServerImpl cs, String name) {  // Wrap around the chosen server this.cs = cs; //Send a welcome message messages.Add(   new Message("***", name + " just connected***")); // Start the asynchronous networking thread. t=new Thread(new ThreadStart(this.run)); t.Start();    }Did I get something wrong?   ;Quote:Original post by KazgorothQuote:Original post by Will FMy understanding is that GDNet articles are submitted to the site and must be approved by a staff member or mod before they can be viewed - which helps keep a lot of the crap out. Plus there's a forum here for discussing articles which can quickly point out any errors.We have an Editorial Review Board which reviews all submitted material before it can be accepted to the site.It's actually a little bit more complicated than just a simple yes/no review. If you're interested in writing an article for us, feel free to check out the "Write for us!" link (at the bottom of pretty much every GDNet page), where you can read more on the review process and how to submit your glorious prose.   ;  *badly ;)Edit: Not a grammar nazi, just thought it was an amusing thread title..   