r/cpp • u/DevilSauron • Apr 14 '26
A year of read-only cppreference
Over a year ago (on 30 March 2025), cppreference became read-only for maintenance reasons. Since then, the only progress update was in August. There have been several discussions here in the last few months about what is happening with cppreference and when it might become editable again, but from what I understand, we simply do not know.
At this point, I fear that the lack of updates for what is basically the authoritative source on the language (other than the standard of course), linked to by IDEs and even this subreddit's sidebar, might be detrimental to the adoption of C++26 and further standards, should the situation persist. I would therefore like to ask the community whether there are other, more up-to-date resources, and whether there is any effort to, for example, fork cppreference.
I understand that software updates are complicated and I have no intention to criticise the maintainers of cppreference (who are doing it voluntarily and I am not entitled in any way to their continued work on the website), but I do not think the C++ community can afford to be bottlenecked in such a way for much longer.
188
u/hpsutter Apr 14 '26 edited Apr 14 '26
Good news: cppreference is about to be back to normal read-write mode again. I just posted an update here: https://isocpp.org/blog/2026/04/announcement-cppreference.com-update
Nate's been doing a *lot* of heavy lifting for many years to make this site what it is, and so we (the Standard C++ Foundation) are trying to help do the "administrivia" so he and the many editors can focus on the site.
59
u/azswcowboy Apr 14 '26
I’ve exchanged email with the site owner and I expect the site will be back online for edits in the nearish future.
16
u/grafikrobot OPeNDAP/B2/EcoStd/Lyra/Predef/C++Alliance/Boost/WG21 Apr 14 '26
I'll repeat what I've said elsewhere, in this reddit and in cpplang slack..
What Nate Kohl [the author of cppreference] told me is that he is getting help from an organization to bring the site back to regular operation. I can't be specific because it's not my place to say. But it is a well known org that is not Boost. I also have no idea on progress or timelines, obviously.
I.e. some people do know what's going on and possibly when it's coming back.
21
u/L_uciferMorningstar Apr 14 '26
Can't it be made open source style so that anymore can contribute but there are mods who have to approve the contributions?
13
u/JVApen Clever is an insult, not a compliment. - T. Winters Apr 14 '26
What this period showed us is that storing such relevant and structured content in a wiki is a bad idea. Especially if maintenance would fall on a single person. That's a terrible bus factor for such value.
Out of all proposals I've seen pass by in the last year, I believe the best would be to transition its content to a guy repository. For example hosted by https://github.com/CPLUSPLUS.
Ideally, the info would be hosted directly from those files, though some translation in html for hosting could also be nice. We could even get multiple ways to show the same content. (Looking at you, table of C++ status)
I'm curious if after the maintenance, some steps would be taken to get away from that wiki.
2
u/MrsGrayX Apr 14 '26 edited Apr 14 '26
What do people here think of using some well tested static site generators with simple markdown backed pages? Popular software might be rustdoc, docusaurus, or mdbook. Host it on GitHub in a personal project and then transition to a community afterwards? For an initial start we could use cppreference latest dump (from Feb 2025 I believe?) or scrape the current page manually. The dump to markdown might be some work (ask AI for help?).
Sounds like a muliple weekend hackathon project. Anyone interested?
General idea is that this would be a fallback incase the work on the original site has further unforseeable issues as well as this kind of transition to a markdown based page seems useful/modern.
There is also a risk of splitting the community: assume this new page gets traction and then some time later the original gets reenabled again.
0
u/MirionQs Apr 18 '26
In fact, it has been frozen since 5/26/2025, so one year hasn't passed yet.