Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • 01:12
    HertzDevil labeled #13014
  • 01:12
    HertzDevil labeled #13014
  • 01:12
    HertzDevil labeled #13014
  • 01:12
    HertzDevil opened #13014
  • 01:05
    straight-shoota edited #13012
  • Jan 26 22:06
    straight-shoota ready_for_review #12978
  • Jan 26 22:06
    straight-shoota edited #13013
  • Jan 26 22:05
    straight-shoota edited #13013
  • Jan 26 22:04
    straight-shoota labeled #13013
  • Jan 26 22:04
    straight-shoota labeled #13013
  • Jan 26 22:04
    straight-shoota labeled #13013
  • Jan 26 22:04
    straight-shoota opened #13013
  • Jan 26 21:28
    straight-shoota labeled #13012
  • Jan 26 21:28
    straight-shoota labeled #13012
  • Jan 26 21:28
    straight-shoota labeled #13012
  • Jan 26 21:28
    straight-shoota opened #13012
  • Jan 26 21:21
    HertzDevil edited #12985
  • Jan 26 21:21
    HertzDevil edited #12985
  • Jan 26 21:19
    HertzDevil edited #12985
  • Jan 26 21:00
    straight-shoota closed #12874
From IRC (bridge bot)
@FromIRC
<postmodern> does crystal docs markdown parser understand tables?
George Dietrich
@Blacksmoke16
I would highly doubt it
But you can try
option b would be using mkdocs crystal extension
From IRC (bridge bot)
@FromIRC
<dostoyevsky2> I use a docker container these days as my dev environment... is there a way I could compile a crystal program for osx from linux/inside a docker container?
George Dietrich
@Blacksmoke16
mac doesn't support static binaries so that might be a bit tricky, however assuming its the same arch and the mac has the libraries installed it should work fine
libraries like ones crystal runtime depends on, i.e. the dynamically linked ones
would be easier to just build on the mac
From IRC (bridge bot)
@FromIRC
<postmodern> so crystal prefers grammatically correct method names, like includes?. What are people's opinions on "indices" vs "indexes"?
From IRC (bridge bot)
@FromIRC
<riza> do what you think is rightd
<riza> a classing example in the rails world is "medium" is the proper singular of "media" but nobody knows that
From IRC (bridge bot)
@FromIRC
<postmodern> do people using write tests for delegateed methods?
From IRC (bridge bot)
@FromIRC
<postmodern> does crystal doc not support inline html, like <code> ?
oprypin
@oprypin:matrix.org
[m]
postmodern, yeah it probably doesn't, (assuming you tried it?) https://github.com/mkdocstrings/crystal supports it, though. what's your use case?
From IRC (bridge bot)
@FromIRC
<postmodern> oprypin, just trying to format a README so that crystal doc renders the proper html
<postmodern> oprypin, unfortunately all of the markdown parsers (github, ruby's kramdowm, and crystal's) all disagree on how to escape within a...or <code></code> element.
<postmodern> oprypin, this actually renders correctly locally using ruby yard+kramdown, but screws up on github: https://github.com/postmodern/chars.rb#features
<postmodern> oprypin, https://github.com/postmodern/chars.cr#features different issues here with escaping inside of a `
<postmodern> i fear this is an unwinnable battle between the doc generator markdown implementation, and whatever werid version github is using to render markdown.
oprypin
@oprypin:matrix.org
[m]
postmodern, prior to me abandoning the use of that generator, i always used to rip out that generated readme. nobody needs it there. and no, GitHub Markdown is most definitely not the weird one of the two.
i used to put a redirect to the main module's page.
and yes it's an unwinnable battle, but also a pointless battle
From IRC (bridge bot)
@FromIRC
<postmodern> oprypin, the README is important as it's the first thing people see. it's the landing page. GitHub just needs to fix their unpredictable markdown generator...
oprypin
@oprypin:matrix.org
[m]
GitHub has the best markdown generator I know. and crystal's one never really reached completeness
From IRC (bridge bot)
@FromIRC
<postmodern> i'm personally not a fan of how dry-rb projects have an almost empty README that just links to some external web page. I don't want to have to clink through links, just tell me what the project is, how to use it, etc
oprypin
@oprypin:matrix.org
[m]
postmodern, people can see the readme on github
From IRC (bridge bot)
@FromIRC
<postmodern> oprypin, check out kramdown. it. just. works.
oprypin
@oprypin:matrix.org
[m]
why would i, if no system uses it
for me github just works
From IRC (bridge bot)
@FromIRC
<jhass[m]> problem is we all should be using commonmark and not markdown
<postmodern> oprypin, github does not work for me. it's markdown rendering does not seem render ` or `\ or <code>`</code> correctly causing a cascading effect https://github.com/postmodern/chars.rb#features if i work around said issies, then i break commonmark or ruby's kramdown (which is pretty much bullet proof)
oprypin
@oprypin:matrix.org
[m]
postmodern, anyway if you want good Markdown rendering and well integrated text+API docs, just use https://mkdocstrings.github.io/crystal/
From IRC (bridge bot)
@FromIRC
<postmodern> oprypin, and does that work for the README.md on github as well :⁠)
<jhass[m]> maybe it likes it as an entity? &
<jhass[m]> &#96;
<postmodern> see i want both proper documentation generation and a README which renders correctly on GitHub
<jhass[m]> probably not inside code tags
oprypin
@oprypin:matrix.org
[m]
eh there are definitely differences in Markdown rendering but much much fewer of them
From IRC (bridge bot)
@FromIRC
<jhass[m]> GFM seems to be a commonmark derivative these days FWIW https://github.github.com/gfm/
oprypin
@oprypin:matrix.org
[m]
or i think this one is more convincing because it's more complicated html inside markdown
From IRC (bridge bot)
@FromIRC
<postmodern> sorry to drag you all into this trivial and stupid problem, the day before the Crystal Conf
<postmodern> but "<code></code>" worked in kramdown, doesn't seem to work incrystal doc`, so that seems like an issue
oprypin
@oprypin:matrix.org
[m]
again, crystal doc's Markdown is completely broken. that i would say is a waste of time
nanobowers
@nanobowers

I've run into an issue where Crystal's Array#fill doesnt work the same as Ruby's (it doesnt allocate additional space, but throws an IndexError), but not sure if this is intentional.

a=[10]
a.fill(9,1,2)
Unhandled exception: Index out of bounds (IndexError)

Ruby returns [10,9,9]

Unsure if the correct course of action is to file an issue, or manage this myself, though i havent seen a non-private method to increase capacity prior to running the #fill
George Dietrich
@Blacksmoke16
it should prob result in you not trying to overfill an array