Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
  • 16:48
    IgorFedchenko synchronize #4022
  • 16:25
    Aaronontheweb commented #4035
  • 16:24
    Aaronontheweb commented #4022
  • 16:23
    Aaronontheweb labeled #4035
  • 16:23
    Aaronontheweb labeled #4035
  • 16:23
    Aaronontheweb opened #4035
  • 16:21
    Aaronontheweb commented #4022
  • 15:54
    Aaronontheweb commented #4022
  • 15:49
    IgorFedchenko commented #4022
  • 15:47
    IgorFedchenko synchronize #4022
  • 15:13

    dependabot-preview[bot] on dev

    Bump Hyperion from 0.9.10 to 0.… (compare)

  • 15:13

    dependabot-preview[bot] on nuget

    (compare)

  • 15:13
    dependabot-preview[bot] closed #4034
  • 15:13
    Aaronontheweb commented #4034
  • 06:55
    dependabot-preview[bot] labeled #4034
  • 06:55

    dependabot-preview[bot] on nuget

    Bump Hyperion from 0.9.10 to 0.… (compare)

  • 06:55
    dependabot-preview[bot] opened #4034
  • Nov 13 22:04
    Aaronontheweb synchronize #4032
  • Nov 13 20:19
    IgorFedchenko commented #4022
  • Nov 13 20:17
    IgorFedchenko commented #4022
Aaron Stannard
@Aaronontheweb
yeah
our docs should be more human-friendly :p
Natan Vivo
@nvivo
one thing I started to worry a little bit is that the docs may need some metadata soon
Aaron Stannard
@Aaronontheweb
like version-specific stuff?
or something else
Natan Vivo
@nvivo
yes. notes about things missing in the version, etc
maybe a way to scan the docs and see what needs to be changed when version changes
but I'm not sure the best way to do it today, or if we should spend time on it now
I think at some point it will become an issue, but not now
Aaron Stannard
@Aaronontheweb
in the little header section where you set the layout and page title you can define your own little variables following that convention
@skotzko is the guy to ask about how to do that best - you don't necessarily need to use those vars on the page, but you can use that to create an update scheme if necessary
Natan Vivo
@nvivo
right
I know there are some platforms like readthedocs.org that already support a lot of stuff. maybe when this becomes an issue, akka.net could try one of those
Aaron Stannard
@Aaronontheweb
yeah we'll just have to see how much of a problem it really is
Natan Vivo
@nvivo
yep
Aaron Stannard
@Aaronontheweb
we have the API docs, which automatically get versioned and updated
Natan Vivo
@nvivo
one thing I know it would be nice to have today is a scanner for dead links
Aaron Stannard
@Aaronontheweb
most of the stuff in these hand-written docs shouldn't change much
Natan Vivo
@nvivo
not sure if the current build system reports this
yeah, maybe the problem is that a lot of the docs are covering things that should be documented in the class docs, like MSDN
Aaron Stannard
@Aaronontheweb
so at the top of the docs inedx
index*
we do have a big link pointing to the API docs
but I'm skeptical that it's obvious enough
Natan Vivo
@nvivo
I saw that
Aaron Stannard
@Aaronontheweb
the API docs have built-in search and other awesome stuff too
they're pretty sweet
SandCastle is pretty amazing once you get over the configuration overhead
Natan Vivo
@nvivo
but could it hold the examples and more text without having to keep all in comments?
Aaron Stannard
@Aaronontheweb
you do have the ability to add custom pages, but really it's meant to be a webified version of XML-doc comments
and small examples do fit nicely in the comments - we do that in a few places
but yeah, you can't really fit a small app in one though
Natan Vivo
@nvivo
I remember reading about the microsoft documentation process
it's quite complex, and they don't have much documentation in the source
not easy to do that
Aaron Stannard
@Aaronontheweb
going to see if I can update our VM image for @Horusiath
so we can unit test the SQL-server Akka.Persistence Impl
Natan Vivo
@nvivo
ok.. and I'll go watch a movie
9pm here... time to stop
Aaron Stannard
@Aaronontheweb
haha
Natan Vivo
@nvivo
aaron, are you married?
does that answer your question?
Natan Vivo
@nvivo
hahahaha
that's why you have so much energy then!
Aaron Stannard
@Aaronontheweb
haha
Joshua Benjamin
@annymsMthd
I now know more about the XUnit inner working than I ever wanted to know.
Aaron Stannard
@Aaronontheweb
@annymsMthd if you stick around on Akka.NET long enough you'll use that sentence for a lot of different things
oh hey, here's how the JVM type system does X!
:P