Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • 18:24
    Blacksmoke16 labeled #12830
  • 18:16
    FnControlOption labeled #12830
  • 18:16
    FnControlOption opened #12830
  • 14:39
    Blacksmoke16 synchronize #10648
  • 12:23
    straight-shoota assigned #12740
  • 12:23
    straight-shoota synchronize #12740
  • 11:28
    straight-shoota closed #11409
  • 11:28
    straight-shoota labeled #11409
  • 11:28
    straight-shoota labeled #11409
  • 11:25
    straight-shoota labeled #12829
  • 11:25
    straight-shoota labeled #12829
  • 11:25
    straight-shoota closed #7532
  • 11:24
    straight-shoota labeled #7532
  • 11:24
    straight-shoota labeled #7532
  • 11:24
    straight-shoota opened #12829
  • 11:12
    straight-shoota milestoned #10531
  • 11:12
    straight-shoota milestoned #10531
  • 08:23
    caspiano edited #10531
  • Dec 08 23:04
    HertzDevil edited #12623
  • Dec 08 22:57
    Blacksmoke16 edited #9745
George Dietrich
@Blacksmoke16
Depends on the exact use case tho. Not going to really harm anything, but is possible it might mess with overload order
baiorett
@baiorett
Depends on the exact use case tho. i don’t think i’m really going to split each class and make tons of class-files
From IRC (bridge bot)
@FromIRC
<postmodern> how do i link to constants in crystal docs?
<postmodern> also references to class-methods don't seem to be auto-linking.
George Dietrich
@Blacksmoke16
@baiorett good :P
surround the const in back ticks
are you using a . instead of #?
From IRC (bridge bot)
@FromIRC
<postmodern> oh derp. kind of weird to overload markdown syntax like that, but ok
<postmodern> so .foo and #foo should link to the appropriate methods? foo won't, correct?
George Dietrich
@Blacksmoke16
it might if its in the same scope/file
From IRC (bridge bot)
@FromIRC
<postmodern> er yeah, found the example in the reference
From IRC (bridge bot)
@FromIRC
<postmodern> where is the repo for the crystal doc command? i noticed it doesn't add a # link next to constants, to allow permalinking to them.
George Dietrich
@Blacksmoke16
It's in crystal codebase
Can link to constants section but not a specific one ATM
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;