Skip to content

[resources] Add cppreference.com - #48

Open
Tsche wants to merge 1 commit into
masterfrom
content/040-resource-general-cppreference-com
Open

[resources] Add cppreference.com#48
Tsche wants to merge 1 commit into
masterfrom
content/040-resource-general-cppreference-com

Conversation

@Tsche

@Tsche Tsche commented Sep 10, 2026

Copy link
Copy Markdown
Member

Content added

Adds cppreference.com to general resources.

Source URL: https://en.cppreference.com/

@Tsche
Tsche force-pushed the content/040-resource-general-cppreference-com branch 2 times, most recently from a4283fb to 270d6a8 Compare September 11, 2026 00:26
@Tsche
Tsche requested a review from a team September 11, 2026 00:26
@Tsche
Tsche force-pushed the content/040-resource-general-cppreference-com branch from 270d6a8 to 720156b Compare September 11, 2026 01:10
@github-actions

Copy link
Copy Markdown

CI report

Commit 720156b

Build

✅ Site built successfully. Download rendered site | logs

Frontend

No matching frontend workflow ran for this change.

Python

No matching python workflow ran for this change.

Other checks

  • Check - Content and Data success. logs
  • Check - YAML success. logs

✅ All completed checks passed.

@github-actions github-actions Bot deleted a comment from Tsche Sep 11, 2026

@term-est term-est left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really think we should mention that this is heavily based on the Working Draft

@eisenwave

Copy link
Copy Markdown

I really think we should mention that this is heavily based on the Working Draft

Not sure what you mean. cppreference is based on the various standards, and something that's based on the current C++29 working draft would be marked (since C++29). Everything up to at least C++23 is based on published standards.

@term-est

Copy link
Copy Markdown
Member

cppreference is based on the various standards

sure, that's what i mean. i am not discussing which drafts and standards it uses, i am discussing that "it uses these heavily"
the idea is that, this is more of a copy-paste of a highly technical document than an actual human readable reference or a "guide"

@Tsche

Tsche commented Sep 13, 2026

Copy link
Copy Markdown
Member Author

I don't follow. cppreference does have some literal standardese in its articles, but also a lot of easier-to-digest descriptions and an overall more docs-like structure.

Do you have a specific suggestion for the description of this card, @term-est?

FWIW cppreference describes it self as

What is the purpose of this site?

Our goal is to provide programmers with a complete online reference for the C and C++ languages and standard libraries, i.e. a more convenient version of the C and C++ standards.

The primary objective is to have a good specification of C and C++. That is, things that are implicitly clear to an experienced programmer should be omitted, or at least separated from the main description of a function, constant or class. A good place to demonstrate various use cases is the "example" section of each page. Rationale, implementation notes, domain specific documentation are preferred to be included in the "notes" section of each page.

https://cppreference.com/Cppreference:FAQ

cards: []
cards:
- title: cppreference.com
path: https://en.cppreference.com/

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

en. should be dropped, the canonical URL is https://cppreference.com/

@term-est term-est left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Something like this, I think it is essential that we mention this

- title: cppreference.com
path: https://en.cppreference.com/
icon: https://raw.githubusercontent.com/isocpp/logos/master/cpp_logo.svg
description: Detailed language and standard-library reference with compiler-support tables

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Something like:

Highly technical language and standard-library reference, often closely following or directly quoting standard wording.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants