I’m in favor of archiving whatever useful Rebol 2 information that is available-- especially if it’s easy (and thankfully this type of text tmunging is a forte for rebol). On the other hand, that stuff is quite dated, and my (mostly minor) concern about keeping that stuff available is that it’s no longer reliable information and could easily become a source of misinformation. When writing Redbol and documenting it’s already a bit of a chore to specify which interpreter and language branch it’s intended for, I can only imagine the confusion it presents for newbies.
If Ren-C is to be positioned as a fully reformed Rebol (as opposed to Red, which in my mind is more of an evolution of Rebol 2.x-- shiny, buffed and rechromed, but an evolution nonetheless), then we likely need to reboot its documentation. Ren-C breaks with its Rebol past quite a bit, and I’m in favor of rewriting the documents to coincide with a major release. I’m also in favor of rewriting & reformatting docs to highlight Ren-C’s key differentiators-- 1, the new standards for writing clean/concise code in Ren-C (i.e., just lang basics here), 2, Ren-C for data wrangling in a networked world, and 3, advanced parse and dialecting (binding will have to get covered in there too). I’ve been using https://twitter.github.io/typeahead.js/ for large static documentation sites at work, so I think it might be a good to connect a lot of the available docs with these menus (another thought: a Ren-C adaptation of DITA XML would form a good document/content management resuse framework https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture)
What do you think? I support archiving the older material and examining it as a reference/starting point for writing Ren-C’s documentation but I also think we need to clean much of the outdated or conflicting information out there. It just muddies the water for anyone trying to get started with Ren-C (or Red, for that matter). Also, what are your thoughts about creating a public-facing site for Ren-C, to showcase all of these materials? (Note: I see the name typed as Ren/C, which is may already be creating SEO issues.) Is now the right time to plan a new site for Ren-C, or are you thinking that github and other wikis are sufficient and this effort is mainly about consolidating/archiving the older Rebol materials?
(Edited for grammer & clarity)