Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • World
  • Users
  • Groups
Skins
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse
Code Project
  1. Home
  2. The Lounge
  3. Is MSDN the best doc. ever ?

Is MSDN the best doc. ever ?

Scheduled Pinned Locked Moved The Lounge
oraclecomjsonquestiondiscussion
32 Posts 13 Posters 0 Views 1 Watching
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • C Christian Graus

    MSDN is the best documentation for Microsoft specific stuff, period. It's natural that with the size of the thing, some things stay in that are dated, etc. However, it's documentation of standard stuff, such as STL, is pitiful. But then, that's not their job, and any C++ programmer worth anything has Stroustrup on their desk for that, right ? Christian I have come to clean zee pooollll. - Michael Martin Dec 30, 2001

    Sonork ID 100.10002:MeanManOz

    I live in Bob's HungOut now

    R Offline
    R Offline
    Ray Hayes
    wrote on last edited by
    #5

    How I wish I could have an electronic copy though! Updated: I'm refering to Stroustup! (Searching is just so much faster) I've got the pulp-copies of most editions, but the newest edition is always at home [I do more pure C++ there] and I've got past the stage of dragging my "library" in to work everyday... It'd be cool to have a copy on my iPAQ too (I've just got to fill the 1Gb microdrive I share between it and my digital camera)! Regards, Ray

    C 1 Reply Last reply
    0
    • R Ray Hayes

      How I wish I could have an electronic copy though! Updated: I'm refering to Stroustup! (Searching is just so much faster) I've got the pulp-copies of most editions, but the newest edition is always at home [I do more pure C++ there] and I've got past the stage of dragging my "library" in to work everyday... It'd be cool to have a copy on my iPAQ too (I've just got to fill the 1Gb microdrive I share between it and my digital camera)! Regards, Ray

      C Offline
      C Offline
      Christian Graus
      wrote on last edited by
      #6

      I've got two copies of Stroustrup for that reason. I've given my prior editions to wanna be programmers ( what can I say, I engender imitation :-)). Although you're right about an electronic copy, I've noticed that Stroustrup is VERY thorough with his indexing. For an example, look up 'moron' in the index. Christian I have come to clean zee pooollll. - Michael Martin Dec 30, 2001

      Sonork ID 100.10002:MeanManOz

      I live in Bob's HungOut now

      J 1 Reply Last reply
      0
      • C Christian Graus

        I've got two copies of Stroustrup for that reason. I've given my prior editions to wanna be programmers ( what can I say, I engender imitation :-)). Although you're right about an electronic copy, I've noticed that Stroustrup is VERY thorough with his indexing. For an example, look up 'moron' in the index. Christian I have come to clean zee pooollll. - Michael Martin Dec 30, 2001

        Sonork ID 100.10002:MeanManOz

        I live in Bob's HungOut now

        J Offline
        J Offline
        jkgh
        wrote on last edited by
        #7

        Mine says: Moron(s), see Bibliography pp 682. But perhaps I have an earlier edition.

        C 1 Reply Last reply
        0
        • D Daniel Turini

          IMHO, yes! When I document the API functions of my software Crivo I always deliberately copy MSDN style, because I think it rocks! But what do you think ? It's common people saying 'MS does not documment well their API functions', 'The examples are idiot!', 'It' very hard to use', 'The GetWadaWadaName() function documentation sucks'. Why they say this ? Only to attack MS monopoly or because they really don't like MSDN style ? If they don't like it, what do they like ? Ok, maybe I'm not that experienced with other platforms. I never saw a better documentation than MSDN in my whole life. My experience with Sun, Oracle, IBM and Sybase docs are a nightmare! Can someone point me a software documentation better than MSDN ? Of course, don't want you to point me to a 3 page doc about a 5 funcion-point software. Crivo Automated Credit Assessment

          M Offline
          M Offline
          Michael P Butler
          wrote on last edited by
          #8

          I love MSDN. Always have since my first look at it in 1994. I used to waste hours of a day just reading through it. This was back in the days before I had Internet access. Nowadays it can be a pain to find things that I'm looking for, but if you know the correct terminology to search for then it is fairly easy to find stuff. I too try and document my classes in the MSDN format. Anybody know what tools Microsoft use to build it? Michael :-) Of course the love of MSDN could die quickly depending on how the forthcoming upgrades and changes to the Library go. I have a very bad feeling about it

          N 1 Reply Last reply
          0
          • M Michael P Butler

            I love MSDN. Always have since my first look at it in 1994. I used to waste hours of a day just reading through it. This was back in the days before I had Internet access. Nowadays it can be a pain to find things that I'm looking for, but if you know the correct terminology to search for then it is fairly easy to find stuff. I too try and document my classes in the MSDN format. Anybody know what tools Microsoft use to build it? Michael :-) Of course the love of MSDN could die quickly depending on how the forthcoming upgrades and changes to the Library go. I have a very bad feeling about it

            N Offline
            N Offline
            Nish Nishant
            wrote on last edited by
            #9

            Anyone knows how to upgrade MSDN? Mine is version 6a and for most of the newer API calls I need to refer the online MSDN. Is there some patch that will upgrade my MSDN for me? Nish p.s. I dont have a subscription. we got our MSDN copies [3 of them] all along with our 3 copies of Visual Studio. That too long ago. Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

            M 1 Reply Last reply
            0
            • D Daniel Turini

              IMHO, yes! When I document the API functions of my software Crivo I always deliberately copy MSDN style, because I think it rocks! But what do you think ? It's common people saying 'MS does not documment well their API functions', 'The examples are idiot!', 'It' very hard to use', 'The GetWadaWadaName() function documentation sucks'. Why they say this ? Only to attack MS monopoly or because they really don't like MSDN style ? If they don't like it, what do they like ? Ok, maybe I'm not that experienced with other platforms. I never saw a better documentation than MSDN in my whole life. My experience with Sun, Oracle, IBM and Sybase docs are a nightmare! Can someone point me a software documentation better than MSDN ? Of course, don't want you to point me to a 3 page doc about a 5 funcion-point software. Crivo Automated Credit Assessment

              D Offline
              D Offline
              dandy72
              wrote on last edited by
              #10

              I'm surprised that there isn't a single negative reply out of the dozen or so already posted by the time I'm writing this. Especially since the MSDN newsgroup has at least one new thread every week about just how horrible the MSDN docs are and it's the worse POS ever made, etc etc. While I'm personally okay with the *style* of the documentation, I have to agree with the #1 newsgroup complaint--searching sucks. Unless you have the *exact* keyword(s), you'll get endless irrelevant results (same as support.microsoft.com, come to think of it). All the "filter" does is gray out items that aren't part of the subset you've selected. We're talking about the MSDN library, right? :-)

              N M 2 Replies Last reply
              0
              • D dandy72

                I'm surprised that there isn't a single negative reply out of the dozen or so already posted by the time I'm writing this. Especially since the MSDN newsgroup has at least one new thread every week about just how horrible the MSDN docs are and it's the worse POS ever made, etc etc. While I'm personally okay with the *style* of the documentation, I have to agree with the #1 newsgroup complaint--searching sucks. Unless you have the *exact* keyword(s), you'll get endless irrelevant results (same as support.microsoft.com, come to think of it). All the "filter" does is gray out items that aren't part of the subset you've selected. We're talking about the MSDN library, right? :-)

                N Offline
                N Offline
                Nish Nishant
                wrote on last edited by
                #11

                Actually I dont even use SEARCH. I use the INDEX a lot more. But you need to search when you want to lookup a KB article and that's when the search sucks :-( Nish Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                1 Reply Last reply
                0
                • N Nish Nishant

                  Anyone knows how to upgrade MSDN? Mine is version 6a and for most of the newer API calls I need to refer the online MSDN. Is there some patch that will upgrade my MSDN for me? Nish p.s. I dont have a subscription. we got our MSDN copies [3 of them] all along with our 3 copies of Visual Studio. That too long ago. Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                  M Offline
                  M Offline
                  Michael P Butler
                  wrote on last edited by
                  #12

                  There is no upgrade. You have to purchase the subscription. I couldn't live without my library subscription. I suppose having it on the Net helps but I don't know how you manage without an up-to date CD. I guess even the library version of MSDN costs a fortune in India :-( Michael :-)

                  N 1 Reply Last reply
                  0
                  • D dandy72

                    I'm surprised that there isn't a single negative reply out of the dozen or so already posted by the time I'm writing this. Especially since the MSDN newsgroup has at least one new thread every week about just how horrible the MSDN docs are and it's the worse POS ever made, etc etc. While I'm personally okay with the *style* of the documentation, I have to agree with the #1 newsgroup complaint--searching sucks. Unless you have the *exact* keyword(s), you'll get endless irrelevant results (same as support.microsoft.com, come to think of it). All the "filter" does is gray out items that aren't part of the subset you've selected. We're talking about the MSDN library, right? :-)

                    M Offline
                    M Offline
                    Michael P Butler
                    wrote on last edited by
                    #13

                    Yeah, the searching is a real pain in the neck somedays. I've got pretty good at locating stuff though although if I'm trying to read up about something I'm not 100% familiar with it can be a real nightmare. Yesterday I was trying to find out how to catch the filedownload in IE. Took me an age to find something until I caught the Browser Helper Objects keyword. Michael :-)

                    1 Reply Last reply
                    0
                    • M Michael P Butler

                      There is no upgrade. You have to purchase the subscription. I couldn't live without my library subscription. I suppose having it on the Net helps but I don't know how you manage without an up-to date CD. I guess even the library version of MSDN costs a fortune in India :-( Michael :-)

                      N Offline
                      N Offline
                      Nish Nishant
                      wrote on last edited by
                      #14

                      Yeah it would. Multiply each US dollar with 47 to get the cost in Indian Rupees and then try and map that with this fact - Indian software engineers earn between 8,000 - 15,000 Indian rupees per month Nish Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                      M J R 3 Replies Last reply
                      0
                      • N Nish Nishant

                        Yeah it would. Multiply each US dollar with 47 to get the cost in Indian Rupees and then try and map that with this fact - Indian software engineers earn between 8,000 - 15,000 Indian rupees per month Nish Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                        M Offline
                        M Offline
                        Michael P Butler
                        wrote on last edited by
                        #15

                        Why doesn't the company you work for invest more in development tools? It's been a long time since I've come across a company in the UK who didn't have an up-to-date MSDN subscription. It became one of my standard interview questions, Do you use MSDN. If they don't, I'd probably turn the job down unless they were interested in getting it. If I were you I'd go and demand a bigger monitor and an MSDN subscription right now. :-D Michael :-)

                        K N 2 Replies Last reply
                        0
                        • C Christian Graus

                          MSDN is the best documentation for Microsoft specific stuff, period. It's natural that with the size of the thing, some things stay in that are dated, etc. However, it's documentation of standard stuff, such as STL, is pitiful. But then, that's not their job, and any C++ programmer worth anything has Stroustrup on their desk for that, right ? Christian I have come to clean zee pooollll. - Michael Martin Dec 30, 2001

                          Sonork ID 100.10002:MeanManOz

                          I live in Bob's HungOut now

                          C Offline
                          C Offline
                          CodeGuy
                          wrote on last edited by
                          #16

                          MSDN is super for examples, but I think the Java documentation is slightly better for documenting classes and methods. The Java docs are terrible for examples though, which is really what you end up needing most of the time. I think what MSDN excels at is task-oriented documentation, like "How to change the color of a static control" and things like that. Re Stroustrup: For anything coherent about STL, I sure don't recommend Stroustrup. Josuittis is much better. I also noticed a lot of people recommending Austern, although I don't like his book as much. I'm not down on Stroustrup at all; it's just that I like people to get a good view of STL, and that means steering them toward good resources. CodeGuy The WTL newsgroup: over 1100 members! Be a part of it. http://groups.yahoo.com/group/wtl

                          M C 2 Replies Last reply
                          0
                          • M Michael P Butler

                            Why doesn't the company you work for invest more in development tools? It's been a long time since I've come across a company in the UK who didn't have an up-to-date MSDN subscription. It became one of my standard interview questions, Do you use MSDN. If they don't, I'd probably turn the job down unless they were interested in getting it. If I were you I'd go and demand a bigger monitor and an MSDN subscription right now. :-D Michael :-)

                            K Offline
                            K Offline
                            Kannan Kalyanaraman
                            wrote on last edited by
                            #17

                            I live/Work in India and my comp. has a universal msdn subscription but even otherwise for companies paying subscription everyyear is still a costly affair. But a medium size company can afford it considering all the ms goodies that come along with the subscription. Cheers Kannan

                            M N 2 Replies Last reply
                            0
                            • K Kannan Kalyanaraman

                              I live/Work in India and my comp. has a universal msdn subscription but even otherwise for companies paying subscription everyyear is still a costly affair. But a medium size company can afford it considering all the ms goodies that come along with the subscription. Cheers Kannan

                              M Offline
                              M Offline
                              Michael P Butler
                              wrote on last edited by
                              #18

                              I can't imagine developing without it. I don't see how any company that develops for the Windows platform can do with out it. To me, it is one of the first things that a development team should have. In fact, it was the first purchase I made when I set-up my own company. I could barely afford it but knew that it was an essential purchase. I just made sure that I didn't pay myself a full wage that first month. Michael :-)

                              N 1 Reply Last reply
                              0
                              • C CodeGuy

                                MSDN is super for examples, but I think the Java documentation is slightly better for documenting classes and methods. The Java docs are terrible for examples though, which is really what you end up needing most of the time. I think what MSDN excels at is task-oriented documentation, like "How to change the color of a static control" and things like that. Re Stroustrup: For anything coherent about STL, I sure don't recommend Stroustrup. Josuittis is much better. I also noticed a lot of people recommending Austern, although I don't like his book as much. I'm not down on Stroustrup at all; it's just that I like people to get a good view of STL, and that means steering them toward good resources. CodeGuy The WTL newsgroup: over 1100 members! Be a part of it. http://groups.yahoo.com/group/wtl

                                M Offline
                                M Offline
                                Michael P Butler
                                wrote on last edited by
                                #19

                                The one thing I used to get annoyed at was the large number of examples that were for VB only. It seems to have got better for providing good examples in both VB and C++ for the newer technologies. Of course, in a couple of years all the examples will be for C# :-D Michael :-)

                                J 1 Reply Last reply
                                0
                                • M Michael P Butler

                                  The one thing I used to get annoyed at was the large number of examples that were for VB only. It seems to have got better for providing good examples in both VB and C++ for the newer technologies. Of course, in a couple of years all the examples will be for C# :-D Michael :-)

                                  J Offline
                                  J Offline
                                  jkgh
                                  wrote on last edited by
                                  #20

                                  Converting from VB to C is fairly easy, but the other way round isn't always so. So I don't mind much. Initially all .Net examples were in C# on MSDN and now almost every example given is in Visual Fred (http://www.mvps.org/vb/index2.html?rants/vfred.htm).

                                  1 Reply Last reply
                                  0
                                  • N Nish Nishant

                                    Yeah it would. Multiply each US dollar with 47 to get the cost in Indian Rupees and then try and map that with this fact - Indian software engineers earn between 8,000 - 15,000 Indian rupees per month Nish Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                                    J Offline
                                    J Offline
                                    jkgh
                                    wrote on last edited by
                                    #21

                                    .. but a single library subscription $200 can be used by your whole company I think. I can't remember if you are allowed to install it at home.

                                    1 Reply Last reply
                                    0
                                    • D Daniel Turini

                                      IMHO, yes! When I document the API functions of my software Crivo I always deliberately copy MSDN style, because I think it rocks! But what do you think ? It's common people saying 'MS does not documment well their API functions', 'The examples are idiot!', 'It' very hard to use', 'The GetWadaWadaName() function documentation sucks'. Why they say this ? Only to attack MS monopoly or because they really don't like MSDN style ? If they don't like it, what do they like ? Ok, maybe I'm not that experienced with other platforms. I never saw a better documentation than MSDN in my whole life. My experience with Sun, Oracle, IBM and Sybase docs are a nightmare! Can someone point me a software documentation better than MSDN ? Of course, don't want you to point me to a 3 page doc about a 5 funcion-point software. Crivo Automated Credit Assessment

                                      N Offline
                                      N Offline
                                      Nemanja Trifunovic
                                      wrote on last edited by
                                      #22

                                      MSDN is great, but Borland C++ 3.1 had the best docs I've ever seen. Every single function had a nice example of use. I vote pro drink :beer:

                                      1 Reply Last reply
                                      0
                                      • N Nish Nishant

                                        Yeah it would. Multiply each US dollar with 47 to get the cost in Indian Rupees and then try and map that with this fact - Indian software engineers earn between 8,000 - 15,000 Indian rupees per month Nish Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                                        R Offline
                                        R Offline
                                        rcVu
                                        wrote on last edited by
                                        #23

                                        If your company pays for one licence of the msdn lybrary they can install it on anyone on your company without paying extra for it. They changed the licenge agrement to this a while ago. Rodrigo.

                                        1 Reply Last reply
                                        0
                                        • M Michael P Butler

                                          Why doesn't the company you work for invest more in development tools? It's been a long time since I've come across a company in the UK who didn't have an up-to-date MSDN subscription. It became one of my standard interview questions, Do you use MSDN. If they don't, I'd probably turn the job down unless they were interested in getting it. If I were you I'd go and demand a bigger monitor and an MSDN subscription right now. :-D Michael :-)

                                          N Offline
                                          N Offline
                                          Nish Nishant
                                          wrote on last edited by
                                          #24

                                          If I were anywhere else but India I'd do that Michael. But not in India. Nish Sonork ID 100.9786 voidmain www.busterboy.org If you don't find me on CP, I'll be at Bob's HungOut

                                          1 Reply Last reply
                                          0
                                          Reply
                                          • Reply as topic
                                          Log in to reply
                                          • Oldest to Newest
                                          • Newest to Oldest
                                          • Most Votes


                                          • Login

                                          • Don't have an account? Register

                                          • Login or register to search.
                                          • First post
                                            Last post
                                          0
                                          • Categories
                                          • Recent
                                          • Tags
                                          • Popular
                                          • World
                                          • Users
                                          • Groups