One thing I've been thinking about as I expand the examples beyond the initial JavaScript ones is that each language should be self-contained. Since the goal of the site is to be educational for members of other programming-language communities, it can't be assumed that anyone coming to the site is already polyglot.
However, there are some bits of information that are common to all examples across all versus' and are mostly just some preambles to understanding C++ code. I think this site is targetted toward more advanced (or adventurous) users, so a full explanation is not necessary, but it might be nice to offer some resources that fill in the gaps, such as:
- understanding
#include statements and how they work
- understanding the various toolchains (clang, gcc, etc) and what defines c++ (the standard)
- understanding package management in c++ (or lack thereof)
- stack vs heap
- C++ versions (11, 14, 17), the standards process (at a high level) to understand how the language changes/evolves
Note: This is likely something that I'll revisit after the 1.0 milestone.
One thing I've been thinking about as I expand the examples beyond the initial JavaScript ones is that each language should be self-contained. Since the goal of the site is to be educational for members of other programming-language communities, it can't be assumed that anyone coming to the site is already polyglot.
However, there are some bits of information that are common to all examples across all versus' and are mostly just some preambles to understanding C++ code. I think this site is targetted toward more advanced (or adventurous) users, so a full explanation is not necessary, but it might be nice to offer some resources that fill in the gaps, such as:
#includestatements and how they workNote: This is likely something that I'll revisit after the
1.0milestone.