Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    Cory Smith
    @DualBrain
    Attempting to work through this on dotnet/dotnet-api-docs#1009
    Maira Wenzel
    @mairaw
    Ok, I'll give you guidance on the issue.
    Cory Smith
    @DualBrain
    It looks like the sample isn't actually part of the document; but rather a "link" to another source file? Where there appears to be a C++ and a C# (though I'm not given that as a choice in order to switch to view the C# version?). Or am I mising something "obvious"? If it is a seperate source file, how does such a file get added/linked? That doesn't appear to be something that GitHub provides for when trying to use the web UI through the "pencil" edit experience.
    André Obelink
    @obelink
    Indeed... the samples you can find in: https://github.com/dotnet/samples
    samples/snippets/csharp/VS_Snippets_Remoting/NCLMailSync/CS/mail.cs#12)
    Cory Smith
    @DualBrain
    @obelink So it does involve a bit more effort to add a new sample. ;-)
    Still strange that the C# sample doesn't appear to be available on the page.
    André Obelink
    @obelink
    Yes, it consists of two PR's… first the sample.
    BTW... it's a known issue that the C++ samples comes up when you select the VB language and that there is no VB sample..
    Kathleen is aware of this and I think it will be addressed in the upcoming period.
    Cory Smith
    @DualBrain
    Well that makes complete sense. ;-)
    Maira Wenzel
    @mairaw
    There will be issues that will be simpler when the code is inline
    Cory Smith
    @DualBrain
    Good thing I can work (a little) in C++. ;-)
    Maira Wenzel
    @mairaw
    I'll be adding more in the coming days/weeks
    Cory Smith
    @DualBrain
    @mairaw Excellent!
    André Obelink
    @obelink
    For the given example earlier, your VB sample should be living here:
    samples/snippets/visualbasic/VS_Snippets_Remoting/NCLMailSync/VB/mail.vb
    Cory Smith
    @DualBrain
    So now that I found the C# version... I suppose that it's that file (mail.cs) that actually needs to be converted to VB... once that is done then the public facing document needs to get updated with essentially "links" to the VB version of the file where each "snippet" on the document points to a particular "<snippetNN>" portion within the VB file. Another question (somewhat related)... does the VB version that basically matches a C# version exist in a similar tree structure (same except "csharp" is replaced with "visualbasic")?
    André Obelink
    @obelink
    Yes... I convert the file one to one to VB, respecting the other file structure. csharp -> visualbasic, CS -> to VB. That's step 1
    Step 2... go to the docs site, click edit and you see the source file. That one you can edit and in that filem you add an extra line with the reference to 'your' vb samples and topic numbers.
    (can we share screenshots here?)
    Arjan van Huizen
    @arjanvanhuizen
    @DualBrain Hi Cory! How are you!? I'm currently assigned to workitem #981 which you can relate to my comment in the details of this issue and see on the parity dashboard. We can't have rights to move the card to the 'In Progress' lane by ourselves. Now it's a bit confusing who does what! But if we are assigned to the issues by the team than it makes more clear. If you already started with this item I'm more than willing to let you finish this and/or help you out if needed.
    https://github.com/dotnet/docs/projects/77
    André Obelink
    @obelink
    [!code-cppNclSslClientAsync#8]
    [!code-csharpNclSslClientAsync#8]
    [!code-vbNclSslClientAsync#8]
    sorry the pasted code is screwed up here, but when you hover over it, you will understand the concept
    Cory Smith
    @DualBrain
    @obelink You can do a screen shot by pointing it to a URL. There is a markdown help button in the bottom right of the app (not sure if there is one in the web-based version or not). Each comment posted fully supports github markdown.
    @arjanvanhuizen Man... the issue list in GitHub is sooo confusing. Issue #1009 is using the same back-end sample as #981. Since you've already stated that you are taking ownership of it... I can step aside. I'll be more than happy to assist if you need. I was just looking at #1009 to get my head wrapped around what is necessary to contrib. ;-)
    Maira Wenzel
    @mairaw
    You're right @DualBrain. Both use the same sample. I'll start adding more EF content to that list and the EF content is all inline.
    Cory Smith
    @DualBrain
    Well, hopefully, my stumbling around in a foreign (at least to me) space might be of help to others. ;-)
    Maira Wenzel
    @mairaw
    Certainly!
    Cory Smith
    @DualBrain
    @mairaw I added https://github.com/dotnet/docs/projects/77 to the room summary.
    Cory Smith
    @DualBrain
    Just noticed that the link in the purple section (note) at the top of https://docs.microsoft.com/en-us/aspnet/web-pages/overview/getting-started/introducing-razor-syntax-c that states "Visual Basic Language and Syntax" ends up at https://dotnet.microsoft.com/apps/aspnet instead of (probably) https://docs.microsoft.com/en-us/aspnet/web-pages/overview/getting-started/introducing-razor-syntax-vb. When I go to edit, the actual underlying link is https://go.microsoft.com/fwlink/?LinkId=202908; the question is then how does one go about changing one of the "magic" go links when they are incorrect? If this link is used elsewhere, it is also going to be going to the wrong place as well. Or... it was the wrong link all along?
    Maira Wenzel
    @mairaw
    Sorry for the delay... haven't been to gitter on the past couple of days
    FwLinks can only be configured internally, so let me check what is the current target destination for that one
    Ok, so this link is configured to go to http://www.asp.net/web-pages/overview/getting-started/introducing-razor-syntax-(vb). So I think we need to do two things here:
    1. I'll fix the FwLink to go to the page you're recommending. It seems to match the original intent
    2. See if we can fix that redirection from the asp.net site
    Cory Smith
    @DualBrain
    @mairaw Sounds good!
    Cory Smith
    @DualBrain
    @mairaw Would this (here) be a good place to discuss the https://github.com/dotnet/try as it relates to us? Whomever is going to be working on this side of things from a Microsoft perspective, could they join us here when the time comes (or rather, nears)? I think it would be great if we could get involved before it's actually ready so that we can participate. ;-)
    Maira Wenzel
    @mairaw
    Let me ask Maria Naggaga
    BTW, the product team fixed those redirects you reported earlier
    Cory Smith
    @DualBrain
    @mairaw Awesome. Thank you!
    Maira Wenzel
    @mairaw
    Maria suggested you open VB issues on the dotnet/try repo. Or were you looking for more of a discussion around the feature?
    Cory Smith
    @DualBrain
    More of a discussion, strategy, wrangling of community (if that is desired), etc. as it relates to VB (when the time is appropriate).
    Maira Wenzel
    @mairaw
    I've added @LadyNaggaga so we can discuss Try .NET here with her. Yes, community help to get that work done for VB is very much needed.
    Cory Smith
    @DualBrain
    Covered this a little bit on my twitch.tv stream; maybe we can get more people involved!
    Cory Smith
    @DualBrain
    The TaskyPortableVB (sample) link at the bottom of https://docs.microsoft.com/en-us/xamarin/cross-platform/platform/visual-basic/ is broken.
    Maira Wenzel
    @mairaw
    I haven't been using Gitter much and I just noticed your broken link report. There's a feedback button on docs.
    I've reported and tagged you @DualBrain
    MicrosoftDocs/xamarin-docs#2269
    Cory Smith
    @DualBrain
    @mairaw Thank you!
    Matt Lacey
    @mrlacey
    I know this channel is a bit quiet but to let everyone know that VB docs are still being written: As of today (almost) all documentation for the Windows Community Toolkit now has samples in VB.Net as well as C#.
    Example: https://docs.microsoft.com/en-us/windows/communitytoolkit/services/linkedin#syntax
    I added the VB versions a few months ago but they only went live today as part of the 6.0 release. The gaps in samples not in VB are new docs created between then and now. I'll add VB versions of code samples to them soon. :)
    Maira Wenzel
    @mairaw
    Thank you @mrlacey!
    Aaron Glover
    @aarondglover
    Great work @mrlacey
    André Obelink
    @obelink
    Wasn't here for a while, but is this overview still actual @mairaw ? https://github.com/dotnet/docs/projects/77