Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
  • 06:51

    dependabot-preview[bot] on nuget

    (compare)

  • 06:51
    dependabot-preview[bot] closed #4041
  • 06:51
    dependabot-preview[bot] commented #4041
  • 06:51
    dependabot-preview[bot] labeled #4051
  • 06:51
    dependabot-preview[bot] opened #4051
  • 06:51

    dependabot-preview[bot] on nuget

    Bump ApprovalTests from 3.0.10 … (compare)

  • 06:51

    dependabot-preview[bot] on nuget

    (compare)

  • 06:51
    dependabot-preview[bot] closed #4040
  • 06:51
    dependabot-preview[bot] commented #4040
  • 06:50
    dependabot-preview[bot] labeled #4050
  • 06:50
    dependabot-preview[bot] opened #4050
  • 06:50

    dependabot-preview[bot] on nuget

    Bump ApprovalUtilities from 3.0… (compare)

  • 06:50

    dependabot-preview[bot] on nuget

    (compare)

  • 06:50
    dependabot-preview[bot] closed #3991
  • 06:50
    dependabot-preview[bot] commented #3991
  • 06:50
    dependabot-preview[bot] labeled #4049
  • 06:50

    dependabot-preview[bot] on nuget

    Bump Microsoft.Extensions.Depen… (compare)

  • 06:50
    dependabot-preview[bot] opened #4049
  • Nov 18 22:20
    IgorFedchenko synchronize #4047
  • Nov 18 22:19
    IgorFedchenko synchronize #4032
Natan Vivo
@nvivo
british humor FTW as you say haha
Aaron Stannard
@Aaronontheweb
@nvivo yeah, I meant inheriting from the Mailbox base class and defining your own. truth be told - we don't really need a section on that. Not a lot of real-world use for it yet
Natan Vivo
@nvivo
that's what I imagined. the implementation from the Mailbox is more complicated, involves understanding more things or inheriting from other classes
Aaron Stannard
@Aaronontheweb
@kekekeks translations of the bootcamp? Into F# ?
Natan Vivo
@nvivo
my plan is to create the initial docs, and then later go back and add some of these details
not sure how long I can focus on this, but I wanna try
Aaron Stannard
@Aaronontheweb
nice man
happy to support you where you need it
Natan Vivo
@nvivo
I read the entire "dispatcher" page from akka, I still cannot explain what they do exactly :-p
I mean, I understand.. but not from the docs
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