red/docs

Red-related user documentation repository

Nenad Rakocevic

@dockimbel

The reactor and deep-reactor functions were enabled only recently. The examples in the Reactivity doc should not have been changed. The make reactor! ... shows that we are building just an object, while reactor ... makes it a black box... Moreover, I am not sure to keep those functions, so documenting them was premature. Last thing, there is a 0.6.5 branch for new changes, as the current branch is there for documenting the last release (0.6.4)...

Gregg Irwin

@greggirwin

We can undo doc updates as needed then.

Nenad Rakocevic

@dockimbel

Just keep in mind that we have several translators that are tracking the changes on master branch, to update their translation. So be sure about what goes into master.

Gregg Irwin

@greggirwin

Yes, balanced with things piling up or not knowing what should be held back from merging.

Nenad Rakocevic

@dockimbel

Commiting in 0.6.5 branch is safer, as only master branch seems to be tracked by the translators.

GiuseppeChillemi

@GiuseppeChillemi

Another difference to document:

Rebol

>> reduce first words-of make object! [b: 22]
== b

Red

>> reduce first words-of make object! [b: 22]
== 22

It seems first is returning an unbounded word in Rebol. I prefer Red way of doing things.

Semseddin Moldibi

@endo64

It's not unbounded on R2 actually:

R2> reduce reduce [first words-of make object! [b: 22]]
== [22]

GiuseppeChillemi

@GiuseppeChillemi

First returns the word which should be bound, reduce should return the contained value. I do not understand the needing for additional block and the double reduce.

Gregg Irwin

@greggirwin

This is the tricky part of all language details not being documented as to their expected behavior. e.g., reduce takes any value, but in R2's case, we don't know how it treats them all. Since Red can also take any type, we may want to tweak the doc string.

GiuseppeChillemi

@GiuseppeChillemi

I'll do further tests to understand more.

hiiamboris

@hiiamboris

Rebol recently tripped me on this thing ☻:

>> a: quote 'x
== 'x
>> type? a
== word!

Very dangerous language compared to Red ;)

Semseddin Moldibi

@endo64

Also:

; R2
a: quote 'x
type? get first [a]
; == lit-word!
 reduce [a]
; == [x]

; Red
type? get first [a]
; == lit-word!
reduce [a]
; == ['x]

GiuseppeChillemi

@GiuseppeChillemi

It should be a bug and not a feature

hiiamboris

@hiiamboris

>> ? mold
...
     /flat        => TBD: Exclude all indentation.
...

Should it still be marked as TBD?

Gregg Irwin

@greggirwin

Good catch. Seems to work for blocks and maps.

Gregg Irwin

@greggirwin

red-by-example.org is now hosted by the Red Foundation. License updates being worked out now.

Thanks to ArieVW and @mikeparr for their efforts, and to @loziniak and @x8x for the technical transition. The source is now available here, so others can contribute.

Maciej Łoziński

@loziniak

Does it mean that red-by-example.github.io can be taken down? I think it's not good with G***le having same content in two places.

Rudolf Meijer

@meijeru

That site is already unreachable (Error 404).

hiiamboris

@hiiamboris

both sites work for me

Rudolf Meijer

@meijeru

I originally had redbyexample without hyphens. That one does indeed not exist (anymore?). However, the one with hyphens on Github says:

Your connection is not private
Attackers might be trying to steal your information from www.red-by-example.github.io (for example, passwords, messages, or credit cards).

So, the one on .org is preferable.

hiiamboris

@hiiamboris

www.red-by-example.github.io doesn't open for me either. No www/ folder on that site it seems

Gregg Irwin

@greggirwin

red-by-example.github.io comes up for me, and via https so no warning. We can, and probably should, take it down though, so there's only one.

Maciej Łoziński

@loziniak

Ok, just took it down. Now it's 404 no matter what :-)

Gregg Irwin

@greggirwin

There can be only one! :^)

Boleslav Březovský

@rebolek

I believe that Linux info on https://www.red-lang.org/p/download.html should be switched.

Currently, it shows instruction for Debian 7/Ubuntu 13.10 first and info for recent distros later. However, people are inattentive and will blindly copy what they see as a first instruction (source: my friend who wants to try Red did this and was pissed that libcurl3 uninstalled libcurl4 from his system).

FLuX LoOP

@x8x

ok inverted :-)

Boleslav Březovský

@rebolek

Thanks :)

Petr Krenzelok

@pekr

b bbb bb b bb b bb bb b b b bb b ; b b b ; b b b b bb b b b b bb b b bbbb b bbb ; b b b b b ; b b bb ; ; b bb bb ;bb ccbbbbbb cbbccbbcbbbcbbb cvbcbbbbbbbbbvbbcbbcb;bbcb;bbbbbbcbcbbbbbbbbbbb ccbbbbbbcbbbcb bbbcb cbcbc bb; b

oh gee, pbone in the car and stuff over the display, sorry ...

Respectech

@Respectech

I thought you were making poetry or rapping...

Petr Krenzelok

@pekr

Maybe it is a Brainfuck language code, I have to check :-)

Semseddin Moldibi

@endo64

I thought it's an ASCII art :)

GiuseppeChillemi

@GiuseppeChillemi

For a moment I have though the output of @toomasv :point_up: script and Petr "art" were related.

Vladimir Vasilyev

@9214

@Tovim I've deleted your wiki page stub entry on to vs. make, as we already have one with the same name and filled-in content. You can add changes to an existing page if you want to.

GiuseppeChillemi

@GiuseppeChillemi

Which markup language is the one used for the wiki?

Gregg Irwin

@greggirwin

Markdown.

GiuseppeChillemi

@GiuseppeChillemi

@greggirwin Thanks

GiuseppeChillemi

@GiuseppeChillemi

How do you edit this?

https://doc.red-lang.org/en/view.html

I mean, is the source somewhere on github?

Gregg Irwin

@greggirwin

https://github.com/red/docs

GiuseppeChillemi

@GiuseppeChillemi

So we use markdown for the wiki and ascidoc for this documentation?

Semseddin Moldibi

@endo64

Yes, correct.
Additionally you can freely edit the wiki pages on red/red repo, but you need to fork, edit locally (or in your fork) then make a pull/merge request to the main repo from your fork, if PR accepted only then your edits become part of the documentation (sorry for redundant info if you already know these)

GiuseppeChillemi

@GiuseppeChillemi

@endo64 I am trying to understand how the whole process. I need to know if wiki pages could be seen as repository files and be forked, modified, merged and also if they can be uploaded remotely.

*how the whole process works

Semseddin Moldibi

@endo64

Wiki pages is a repo, you can clone it with https://github.com/red/red.wiki.git which is different than the main repo (https://github.com/red/red.git).
You can create a branch, edit locally, merge it to master and push to the repo, since it is available to publicly editable, no need to fork & make PRs.

But working locally on wiki pages then push is harder than editing online, because someone else may updates, then you need to take those updates solve the conflict (if any), merge locally and push.

Here are some (not much) help: https://help.github.com/en/github/building-a-strong-community/adding-or-editing-wiki-pages#adding-or-editing-wiki-pages-locally

Where communities thrive

People

Repo info

Activity