Where communities thrive

Join over 1.5M+ people
Join over 100K+ communities
Free without limits
Create your own community

Explore more communities

red/docs

Red-related user documentation repository

People

Repo info

Activity

Aug 09 14:01

dockimbel on master

FEAT: updates the list of named… (compare)
Aug 08 12:27

dockimbel on master

FIX: prepends rich-text context… (compare)
Aug 07 20:24

dockimbel on master

FIX: removes the mention of dia… (compare)
Aug 07 10:49

dockimbel on master

FEAT: adds description for opti… (compare)
Aug 05 16:23

dockimbel on master

FEAT: adds new definition for K… (compare)
May 19 20:58

greggirwin commented #273
May 19 20:58

greggirwin on master

docs/cs/datatype/ modified 33 f… docs/cs/ 17 modified + 1 new fi… Merge pull request #273 from To… (compare)
May 19 20:58

greggirwin closed #273
Apr 24 19:46

Tovim reopened #273
Apr 24 19:46

Tovim closed #273
Apr 24 19:46

Tovim reopened #273
Apr 24 19:45

Tovim closed #273
Apr 24 19:04

Tovim opened #273
Apr 16 14:49

gurzgri opened #272
Feb 15 20:02

greggirwin on master

Add note about redbin size. (compare)
Feb 03 18:24

dockimbel commented #271
Feb 03 18:23

greggirwin commented #271
Feb 03 18:21

dockimbel commented #271
Feb 03 18:20

dockimbel commented #271
Feb 03 18:19

dockimbel assigned #271

gltewalt (The other Greg)

@gltewalt:matrix.org

[m]

Fairly tightly knit with python - have to use python locally, install sphinx and recommonmark through the package manager, and edit a .py config file. I'm not sure that the Red team wants to lean on python tooling, though there is a balance somewhere between being reliant on other things, and doing everything in house.

A local docs directory would be the sphinx project scaffolding

Gregg Irwin

@greggirwin

That's a bummer. Yeah, we may not want to do all that.

@x8x do we have any other Python dependencies in our webhook chain for other stuff at this point?

gltewalt (The other Greg)

@gltewalt:matrix.org

[m]

There is also asciidoctor which spits out htm from asciidoc by default.

https://asciidoctor.org

Looks good to the viewer, pretty noisy when viewing source

FLuX

@x8x

We don't use Python for anything that I can think of.

Gregg Irwin

@greggirwin

Thanks @x8x. So we probably won't pursue that @gltewalt:matrix.org. If there's someone in the community that wants to host that process, knows Python, and all we need to do is provide content in a given format for them to pull, we could look at that.

Filip Oščádal

@mxdpeep

There is also asciidoctor which spits out htm from asciidoc by default.
https://asciidoctor.org

I use it daily from a docker container, works

Greg T

@gltewalt

I think asciidoctor is the best bet for right now - if you want html version of the asciidoc docs.

Their site is composed in asciidoc. The html that you see if from asciidoctor, with their own css style.

https://asciidoctor.org/

Bonus - the headers are colored red

FLuX

@x8x

@gltewalt we use asciidoctor since always.. and we also do SPA and PWA if that's the new buzz words.. :smiley:

Greg T

@gltewalt

'We' as in?

FLuX

@x8x

https://docs.github.com/en/github-ae@latest/developers/webhooks-and-events/webhooks

Thanks! That looks like an interesting option! :thumbsup:

Greg T

@gltewalt

This could use some volunteers. Last touched in January.
https://github.com/red/red/wiki/%5BHOWTO%5D-How-Do-I-Do-X-with-Red%3F

The common How-Tos could be factored out and used as a kind of parent class to the "How Do I", and the "Coming to Red from another language" writings

Cross referenced, at least

Gregg Irwin

@greggirwin

:+1:

mikeparr

@mikeparr

@gltewalt I wonder if this 'CommonTasks In Series' material is any use? https://www.red-by-example.org/series.html#15

Greg T

@gltewalt

Yes, good information. Should probably link to those from "How Do I"

rseger

@rseger

I added a suggested "potential gotchas" section to https://github.com/red/red/wiki/Coming-to-Red-from-Python. And added a note about namespaces (hopefully a helpful one) - feel free to tweak/remove as desired :)

Gregg Irwin

@greggirwin

Good stuff @rseger , thanks!

Another thing you might hear is that "words carry their context with them".

rseger

@rseger

my pleasure :)

Greg T

@gltewalt

the "zipped" Direct links to latest builds links are dead on the download page

gltewalt (The other Greg)

@gltewalt:matrix.org

[m]

Red by example still alive?

Screenshot_20210805-085148_Samsung Internet.jpg

Gregg Irwin

@greggirwin

It's an open effort now: https://github.com/red-by-example/red-by-example with @mikeparr and ArieVW as honorary advisors.

mikeparr

@mikeparr

Thanks Gregg

Toomas Vooglaid

@toomasv

There is following proposition in map documentation:

Trying to access a key not defined in a map will:

produce an error if the path syntax is used.

return a none value if select is used.

But on Windows accessing non-existing key with path syntax returns none, not error. Which is wrong, documentation or Windows' behavior?

Gregg Irwin

@greggirwin

Documentation is wrong. That was the original behavior, and docs never got updated. Good catch, and please file a ticket for it.

Toomas Vooglaid

@toomasv

Ok, will do.

Petr Krenzelok

@pekr

English is not my native language, but shouldn't == Function attributsbe == Function attributesinstead?

gltewalt (The other Greg)

@gltewalt:matrix.org

[m]

Yep

Gregg Irwin

@greggirwin

Thanks @pekr. Fixed.

Greg T

@gltewalt

I saw the split comparison doc. Surprised you didn't look at haskell.
https://hackage.haskell.org/package/split-0.2.3.4/docs/Data-List-Split.html

Gregg Irwin

@greggirwin

We can add it. Just can't cover everything. I, personally, didn't think of Haskell because any time I look at Haskell examples, it seems they don't use words. :^)

Link added.

Gregg Irwin

@greggirwin

And when they do use words, they're things like "strategy transformers" and "derived combinators". I'm just a simple man. splitWhen is a really nice name though, using "when" for "When you encounter...".

gltewalt (The other Greg)

@gltewalt:matrix.org

[m]

Yeah, I've only made it to understanding about 50% of the egghead stuff, but their utility functions mostly make sense, and that community geeks out with 50 different ways of solving everything.

Gregg Irwin

@greggirwin

that community geeks out with 50 different ways of solving everything.

They're catching up to us! ;^)

GiuseppeChillemi

@GiuseppeChillemi

Red is a readable language, you understand what it does since the first reads.

Greg T

@gltewalt

Depends on how you write.

Rudolf Meijer

@meijeru

@dockimbel @greggirwin
In the most recent blog post I read (to my satisfaction) the planned work item:
Red Language Specification (Principles, Core Language, Evaluation Rules, Datatype Specs (including literal forms), Action/Native specs, Modules spec.
Let me reconfirm that the work I have put into the specification document here is fully available for use in progressing this work item, in whatever way is thought appropriate.

Gregg Irwin

@greggirwin

@meijeru absolutely. I imagine that will be the foundation we work from. We want to a) make it clear what parts of Red have a hard, unchanging (as much as we can), spec; b) firmer style guidelines for things like custom datatypes (not including new lexical forms) and how to make sure contributions (including those from the team), align with the big design picture. Finally, c) I'd love to be able to treat specs as data where we can, for more interactive tools, including analysis for new work. e.g. if we have specs we can apply as rules, how do we do that?

In any case, your work will be an important aspect, and we'll certainly reach out to leverage your knowledge and expertise.

Rudolf Meijer

@meijeru

I just (re-)discovered https://w.red-lang.org/en/. What is the status of this doc-site now?

Civan

@Red-Beginner

@meijeru It looks like a fan site. Probably it copied from the original documents.

Gregg Irwin

@greggirwin

That was @x8x's work, but doesn't seem to have been kept up to date.

Rudolf Meijer

@meijeru

It seems to be derived from https://github.com/red/docs/tree/master/en/, which I hope IS up-to-date. Maybe @x8x can tell us what the status is.

Gregg Irwin

@greggirwin

Yes, I just don't know if it's kept up via automation.

Chat via Matrix