Why is C++ documentation SO BAD?!

Поделиться
HTML-код
  • Опубликовано: 15 май 2024
  • НаукаНаука

Комментарии • 57

  • @codingwithmat
    @codingwithmat  29 дней назад +4

    What's your favourite complicated cppreference page? 😅

    • @Aj_codes
      @Aj_codes 24 дня назад

      Official documentation page for cpp boost asio…. Man

    • @tsunekakou1275
      @tsunekakou1275 6 дней назад

      C++20 coroutine, the control flow is complex by itself.

  • @T0m1s
    @T0m1s 15 дней назад +34

    That site is not intended for beginners. It's meant to be very precise, not-beginner friendly. It assumes you're somewhere familiar with C++.

  • @jaime5601
    @jaime5601 29 дней назад +45

    so true, sometimes i get chatgpt to write some clearer example code if i need to understand something where the docs are too confusing

    • @codingwithmat
      @codingwithmat  29 дней назад +6

      💯 this is what I've been doing too recently... And I'm a seasoned cop developer

    • @jaime5601
      @jaime5601 29 дней назад +1

      ​@@codingwithmat good to know i'm not alone in this!

    • @byronvega8298
      @byronvega8298 29 дней назад +1

      I've been doing that for so long!

  • @avramlevitter6150
    @avramlevitter6150 10 дней назад +3

    I think a bit of the confusion here is that cppreference isn't meant to be a resource for beginners, it's meant to be an open-source copy of the C++ ISO standard that's better categorized and formatted. There are plenty of other websites with better C++ beginner resources that can give a much better explanation of what std::forward does.

  • @germanassasin1046
    @germanassasin1046 17 дней назад +8

    But cppreference isn't a documentation. It is an attempt to translate c++ standard from standardese to something that humans can understand. It is not a place where you should learn c++. Use something like learncpp or cppcon back to basics series.

  • @LudwigvanBeethoven2
    @LudwigvanBeethoven2 29 дней назад +21

    Atleast its detailed. Some documentations go the other way, that is too simple and doesn't give much detail

    • @poudelaayush
      @poudelaayush 13 дней назад +1

      Too simple is better than this shit. They should write 2 sections for each function/thing, a small section with a simple example and then all the technical jargon afterwards.

    • @plaintext7288
      @plaintext7288 9 дней назад

      We need cppreference for dummies

  • @nexovec
    @nexovec 29 дней назад +18

    Tbh. Cppreference is actually not that terrible, ever seen llvm doxygen files?

    • @codingwithmat
      @codingwithmat  29 дней назад +5

      Certain libraries are the exception. Comparing to Rust (the context of the video) for example, the documentation approach is unified and the same everywhere, making it easier to find the docs you need very easily.
      Doxygen is good if used properly. On the stream I mention that there are libraries fairly well documented (boost, qt etc)

    • @codingwithmat
      @codingwithmat  29 дней назад +10

      Btw I stay away from llvm / GCC docs. Nothing can be worse than those hahaha

  • @Mustlight
    @Mustlight 29 дней назад +7

    I completely agree on you with this. If i want to learn something new, i don't generally use documentation because of the complexity of some of the code.

  • @johanngerell
    @johanngerell 18 дней назад +1

    To be fair, "if as a beginner" - I can't see a reasonable scenario where a beginner would *need* std::forward...

    • @codingwithmat
      @codingwithmat  18 дней назад

      You are a beginner and just integrated `fmt` into your code. You are curious to see how `println` is implemented so you F12 it... boom, std::forward right there...
      They won't "need it" but they will come across it, that's the point made in the video

    • @johanngerell
      @johanngerell 18 дней назад +1

      @@codingwithmat fair enough :)

  • @ilovenirajan
    @ilovenirajan 8 дней назад +2

    just because u don't like it doesn't mean it's bad. Cppreference is one of top-notch documentation of high quality. I would never want it to be like geeksforgeeks or some tutorial blog.

  • @shadowchasernql
    @shadowchasernql 2 дня назад

    Yup! And that's why I'm a pure C guy all the way! I can have a whole reference, step-by-step tutorial and guide and erratas all on my desk, and in less than one claws-length too! It's lovely!

  • @stintaa
    @stintaa 28 дней назад +3

    This is when I like Microsoft’s MSVC docs

  • @PrathameshThorat1729
    @PrathameshThorat1729 28 дней назад +3

    Viewing or reading docs also keep "Tutorial Hell" apart

  • @Candyrizz00
    @Candyrizz00 29 дней назад +1

    From POV after some time or year you get good understanding of thing by syntax than documentation and also documentation is important but for that u can find other site not standard c++ documentation see people at different stage need to see different thing and this is the highest peek

  • @therealsoulbringer
    @therealsoulbringer 25 дней назад +3

    Git gud is my favorite method 🌚

  • @Mr.Not_Sure
    @Mr.Not_Sure 21 день назад +4

    That's why people learn C++ in colleges or by reading books or tutorials.
    The cppreference site is reference, not tutorial.

    • @codingwithmat
      @codingwithmat  21 день назад +3

      People shouldn't need to buy a book or go to college to learn a programming language. Documentation is definitely one of the best places to learn a language. Just unlucky we don't have good docs standards in C++

    • @Ash-qp2yw
      @Ash-qp2yw 12 дней назад

      @@codingwithmat Agreedc there - I learned c++ by going through learncpp and watching cppcon videos and help on the TCCPP discord. Cppref is good, but learning to read and understand it is a skill you have to learn, and often I'll combine looking at that with checking out SO answers

  • @ZettaiKatsu2013
    @ZettaiKatsu2013 13 дней назад

    If a child is unable read and understand the stuff, the documents are not acceptable.

  • @aberba
    @aberba 7 дней назад +1

    You seem to still misunderstand here. A language reference is a technical document, not exactly a documentation (learning document) like you seem to think. Have you seen the JavaScript reference? It's complicated too.
    It's like looking at a building schematics, they're technical. They're not meant for beginners. With that said, C++ isn't a clean language either so that doesn't make it easier, so many exceptions to exceptions, and complicated template/generics salad.

  • @orbatos
    @orbatos 13 дней назад

    And it's never going to get better, even as the language continues to grow at a greater rate. This will never get better.

  • @JMIK1991
    @JMIK1991 15 дней назад

    Ahh... another great find in cppreference. Thanks.

  • @VladykaVladykov
    @VladykaVladykov 4 дня назад +1

    Если ты новичок, то std::forward тебе не нужен

  • @Seacle14
    @Seacle14 3 дня назад

    A beginner is not going to read the reference for the c++ standard library...

  • @thegoodguy8208
    @thegoodguy8208 14 дней назад

    for your information std::forward is not for beginners.

  • @RedstonekPL
    @RedstonekPL 19 дней назад +2

    i mean thats a skill issue if ive ever seen one
    i much prefer cppreference than any doxygen-generated documentation

  • @CC-1.
    @CC-1. 29 дней назад

    It's simple,
    The thing which isn't correct is the fact that it's very hard to translate logic Etc

  • @Vinzmannn
    @Vinzmannn День назад

    I disagree. Julia documentation is much worse. Python is way better. I'd say c++ sits square in the middle. Thank you for coming to my Ted Talk

  • @uunium
    @uunium 29 дней назад +1

    Me and python documentation

    • @Karurosagu
      @Karurosagu 22 дня назад +2

      Python is a piece of cake

  • @alkon8032
    @alkon8032 28 дней назад +1

    If Rex Orange County was in IT

  • @HighMojo
    @HighMojo 29 дней назад +3

    I abandoned C++ decades ago, and kept my sanity.

  • @user-cg1ul8bh8w
    @user-cg1ul8bh8w 29 дней назад

    I just ask chat gpt to explain me cpp now.... It works better... "my personal teacher and programmer"

  • @alxioo
    @alxioo 7 дней назад

    Still better than python

  • @Ari-ez1vj
    @Ari-ez1vj 3 дня назад

    i see u have the c++ bags under ur eyes too

  • @Im_Ninooo
    @Im_Ninooo 7 дней назад

    well, if you're a beginner starting to learn C++.. that's your mistake right there. learn something else.

  • @andrewvvictorio7084
    @andrewvvictorio7084 28 дней назад

    I agree

  • @olbld
    @olbld 29 дней назад +2

    C/C++ is not for softboys. If you are a beginner and you can't get into cppreference, ANSI/IEC, you don't need it. Don't even try, unless it is difficult for you, but surmountable and you are not afraid. Language syntax and libraries are a fraction of all knowledge. Take into account platforms, compilers. Sometimes programs are deliberately written with errors (undefined behaviour in benchmarks, for example) and you should see and understand it.