Skip to content

Release notes for 0.2 are not linked from the .sln, but those for 0.1 are #322

Closed

Description

@markusweimer

When browsing the docs folder via Visual Studio, there are release notes for ML.NET 0.1 listed. However, the release notes for 0.2 are missing. They are, in fact, in the file system.

We should have a consistent scheme here: Either the files are always added to the solution file, or never.

Activity

  1. markusweimer commented on Jun 6, 2018

    @markusweimer
    Author

    @GalOshri WDYT? Which way should we go?

  2. markusweimer commented on Jun 6, 2018

    @markusweimer
    Author

    Actually, we have that issue for many of our .md files.

  3. GalOshri commented on Jun 8, 2018

    @GalOshri
    Contributor

    I don't have a strong preference. I'd imagine it would be useful to include documentation that explains code concepts in the solution, but that doesn't apply to release notes. If we want to be completely consistent, we can keep everything in the solution. Thoughts?

  4. TomFinley commented on Jun 8, 2018

    @TomFinley
    Contributor

    @GalOshri and @markusweimer... assuming we care about having the .md files accessible in VS (I personally have never found that useful, but maybe other people do), if we had a project that did not produce any build artifact called "Documentation" or somesuch, that might be a better alternative to keeping things in solution items. That project could easily be set up to just track the docs directory just as all existing "code" projects track their directories. Then we wouldn't have to keep a separate list in something as awkward to deal with in an .sln file.

    (@markusweimer , should I take this issue to mean you are an enthusiastic VS user?)

  5. Nepomuceno commented on Jun 14, 2018

    @Nepomuceno
    Contributor

    I would argue that this files are not actually part of the solution since they are not part of the build so they should not be included as part of the solution. But I understand the argument of keeping them as reference. But since the code has plenty of reference and I don't imagine that someone that it is going to look for extra references will be doing that by reading .md files on VS Removing them to keep the solution clean would be a better idea.

  6. ghost locked as resolved and limited conversation to collaborators on Mar 30, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions