Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
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?
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.