Skip to content

C# tutorials - versioning #56

Closed
Closed

Description

@stevehoag

Should teach versioning in C# through the use of the override and new keywords.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Activity

  1. added
    help wantedGood for community contributors to help [up-for-grabs]
    on Dec 11, 2015
  2. removed
    help wantedGood for community contributors to help [up-for-grabs]
    on Feb 3, 2016
  3. modified the milestone: on Jul 22, 2016
  4. tonerdo commented on Sep 6, 2016

    @tonerdo
    Contributor

    @BillWagner up for grabs?

  5. added
    help wantedGood for community contributors to help [up-for-grabs]
    on Sep 6, 2016
  6. BillWagner commented on Sep 6, 2016

    @BillWagner
    Member

    @tsolarin Sure. Do you want to work on this one?

    If so, let's learn from our experience with the XML doc article. Let's start with an outline, either as a comment on this issue, or as a PR with a Work in Progress (WIP) comment. Then, once we agree that the outline is good, then move forward. I want to avoid having you do as much re-work as the last time.

  7. tonerdo commented on Sep 6, 2016

    @tonerdo
    Contributor

    Sure @BillWagner, I'll get to creating a barebones first draft and post the link here once it's ready

  8. tonerdo commented on Sep 26, 2016

    @tonerdo
    Contributor

    Sorry for the delay been a bit busy. Here's my outline https://github.com/tsolarin/core-docs/blob/versioning/docs/csharp/versioning.md. I couldn't find a pre-existing versioning page that contained documentation metadata.

    Looking forward to your feedback

  9. tonerdo commented on Sep 27, 2016

    @tonerdo
    Contributor
  10. BillWagner commented on Sep 27, 2016

    @BillWagner
    Member

    @tsolarin I will look at this today. (Got totally slammed yesterday).

    Update: I've got a lot of deliverables this week related to Ignite. I'll review by Monday am.

  11. BillWagner commented on Oct 2, 2016

    @BillWagner
    Member

    /cc @stevehoag (He wrote the original issue)

    I'd like to see you approach this in terms of what happens for any of these kinds of methods when base classes change. For example:

    1. What happens when a base class adds new overrides of a virtual method?
    2. What happens when a base class adds new methods that conflict with a derived class's methods?
    3. What happens when a base class changes the default value on any optional arguments?

    Overall, readers should learn what changes they can make in version 2 (and later) that won't negatively impact the developers that created derived classes?

    And, if a base class does make those kinds of breaking changes, how should the derived class author react?

  12. modified the milestones: , on Nov 30, 2016
  13. modified the milestones: January 2017, on Jan 31, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

help wantedGood for community contributors to help [up-for-grabs]

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions