nugetdocs Issue Tracker Rss Feed

Created Issue: Doc on nuget pack / metadata [45]

aldion — Wed, 11 Jul 2012 18:21:56 GMT

from http://nuget.codeplex.com/workitem/2416

"If the nuspec is in the same directory as the project file, the pack command will use metadata from the file."
"It would be cool of you guys if you could update the documentation to make clear that the nuspec and project files are supposed to be in the same directory for this to work :)"

Created Issue: Document pack workflow w/ dependencies [44]

aldion — Tue, 10 Jul 2012 23:20:54 GMT

redirected from http://nuget.codeplex.com/workitem/2405

Created Issue: Add documentation about how to connect to the feed behind a proxy [43]

danliu — Fri, 08 Jun 2012 23:25:53 GMT

The fix to issue http://nuget.codeplex.com/workitem/1924 is adding a new feature to nuget.

We need to add documentation to docs.nuget.org so people will know how to use this feature while working behind a proxy.

Created Issue: Update docs to note that nuget pack ignores files/folders that start with a dot character [42]

Haacked — Mon, 03 Oct 2011 04:05:10 GMT

See issue http://nuget.codeplex.com/workitem/1582 for details.

Created Issue: Updated docs with info about safe updates during install [41]

Haacked — Mon, 03 Oct 2011 03:40:08 GMT

From here: http://nuget.codeplex.com/workitem/1583

Documentation states that, for dependencies that are already installed:

"If the dependency is already installed, then one of two things happens:
* If the installed dependency is within the version range, then nothing more needs to happen. The dependency is met.
* If the installed dependency is outside of the version range, installation fails. (Version leveling in a future version of NuGet will fix this.)"

This doesn't seem to be the actual behavior, based on this:

PM> Install-Package Newtonsoft.Json -Version 4.0.2
Successfully installed 'Newtonsoft.Json 4.0.2'.
Successfully added 'Newtonsoft.Json 4.0.2' to Foo.Tests.ApiTests.

PM> Install-Package RestSharp -Version 101.3
Attempting to resolve dependency 'Newtonsoft.Json'.
Successfully installed 'Newtonsoft.Json 4.0.3'.
Successfully installed 'RestSharp 101.3'.
Successfully removed 'Newtonsoft.Json 4.0.2' from Foo.Tests.ApiTests.
Successfully added 'Newtonsoft.Json 4.0.3' to Foo.Tests.ApiTests.
Successfully added 'RestSharp 101.3' to Foo.Tests.ApiTests.
Successfully uninstalled 'Newtonsoft.Json 4.0.2'.

The dependency in RestSharp.nuspec does not have any particular version number.
<dependency id="Newtonsoft.Json" />

Ah, I think the docs are outdated. I think we do "safe" upgrades based on the semantics of SemVer, http://semver.org/. Assuming a version of X.Y.Z, Patch version Z (x.y.Z | x > 0) MUST be incremented if only backwards compatible bug fixes are introduced. A bug fix is defined as an internal change that fixes incorrect behavior.

We figured you probably want bug fixes. Of course, not every package author follows this, but we're going to try and encourage it more and more. If the package author did break you, please contact them and tell them adding breaking changes without incrementing the Major (or at least Minor) version is not nice.

In the meanwhile, if you want to lock that version, you can by hand editing packages.config and adding an allowedVersions attribute with a version range. In your case:

<package id="NewtonSoft.Json" allowedVersion="[4.0.2]" />

Created Issue: Add an overview of the NuGet ecosystem to Docs [40]

XavierDecoster — Fri, 30 Sep 2011 20:47:15 GMT

starting point could be http://www.xavierdecoster.com/post/2011/09/30/An-overview-of-the-NuGet-ecosystem.aspx

Commented Issue: Code Review page 404 [29]

aldion — Wed, 28 Sep 2011 18:59:52 GMT

The page http://docs.nuget.org/docs/contribute/Code-Reviews, which is linked from several other locations in the NuGet docs, (such as from here: http://docs.nuget.org/docs/contribute/contributing-to-nuget) returns a 404. I can't find any other sources on the NuGet docs site about code reviews.
Comments: nevermind. the page is old it should probably be taken down since it returns in search engines... :)

Commented Issue: Code Review page 404 [29]

aldion — Wed, 28 Sep 2011 18:58:09 GMT

The page http://docs.nuget.org/docs/contribute/Code-Reviews, which is linked from several other locations in the NuGet docs, (such as from here: http://docs.nuget.org/docs/contribute/contributing-to-nuget) returns a 404. I can't find any other sources on the NuGet docs site about code reviews.
Comments: Note: the page exist in "vnext" : http://preview.docs.nuget.org/docs/contribute/code-reviews but not in "default" : http://docs.nuget.org/docs/contribute/code-reviews this should be fixed once the branches are merged.

Commented Issue: documentation for nuspec file -exclude misleading [39]

aldion — Wed, 28 Sep 2011 18:43:57 GMT

follow up to http://nuget.codeplex.com/workitem/1498
Comments: Fixed with changeset 3064c431e43b

Edited Issue: documentation for nuspec file -exclude misleading [39]

aldion — Wed, 28 Sep 2011 18:43:57 GMT

follow up to http://nuget.codeplex.com/workitem/1498

Created Issue: documentation for nuspec file -exclude misleading [39]

aldion — Wed, 28 Sep 2011 18:08:35 GMT

follow up to http://nuget.codeplex.com/workitem/1498

Created Issue: Nuget documents for command line should explain layout of %AppData%\NuGet\NuGet.config [38]

Haacked — Fri, 23 Sep 2011 03:25:59 GMT

The command line documentation at http://docs.nuget.org/docs/reference/command-line-reference says "If no sources are specified, all sources defined in %AppData%\NuGet\NuGet.config are used." but does not explain what the format of that file should be, and, by default it's empty.

Suggest: documentation should link to a page explaining NuGet.config that documents the format for adding package references.

Created Issue: Add Documentation for upcoming Pre-release feature NuGet 1.6 [37]

Haacked — Thu, 22 Sep 2011 19:56:37 GMT

We need to document this for client and website.

Created Issue: Update NuGet.Server docs to reflect features added in 1.5 [36]

dfowler — Wed, 07 Sep 2011 17:53:39 GMT

We added the ability to specify where the packages folder should go in nuget 1.5 and the docs need to be updated to reflect this.

Created Issue: install.ps1 firing behavior not clear in documentation [35]

aldion — Thu, 01 Sep 2011 23:05:13 GMT

originally filed :http://nuget.codeplex.com/workitem/1468

"This text is from: http://docs.nuget.org/docs/creating-packages/creating-and-publishing-a-package

Install.ps1 runs when a package is installed in a project.
◦If the same package is installed in multiple projects in a solution, the script runs each time the package is installed.
◦If a package is not installed into a project (such as the tools only package), the script runs when the package is installed into the solution.
◦The package must have files in the content or lib folder for Install.ps1 to run. Just having something in the tools folder will not kick this off.
◦If your package also has an init.ps1, install.ps1 runs after init.ps1.

It seems like lines 2 and 3 aren't self consistent. You have to have something in the content or lib folder for Install.ps1 to fire. But if you only hvae stuff in the tools folder then it will fire. The confusion may be caused by a misunderstanding of "tools only package", but I was not able to find a definition of that term anywhere else on that web page."

Created Issue: Doc Outline has broken link if it contains encoded characters [34]

aldion — Tue, 30 Aug 2011 22:35:01 GMT

go to :
http://docs.nuget.org/docs/release-notes/nuget-1.5#%3ccode%3eGet-Package%3c%2fcode%3e_command_improvement

in the Doc outline :
- NuSpec <files /> improvement
- Bug fixes worth noting:
- Get-Package command improvement

these links are broken, are one shows some HTML

Created Issue: Integrate directly with AppHarbor [33]

Haacked — Fri, 26 Aug 2011 18:09:21 GMT

http://blogs.msdn.com/b/codeplex/archive/2011/08/26/integration-with-appharbor.aspx

Edited Issue: Doc: Changes to Update-Package - support for updating all projects/packages [13]

Haacked — Wed, 24 Aug 2011 05:36:12 GMT

Need to document these new changes. See http://nuget.codeplex.com/wikipage?title=Updating%20All%20Packages

Please update the spec and assign to me. I'll update the docs.

Commented Issue: Doc: Solution Level Add Package Dialog [12]

Haacked — Wed, 24 Aug 2011 05:35:50 GMT

Need to document this. Perhaps as part of http://docs.nuget.org/docs/start-here/using-the-add-library-package-reference-dialog-box.
Comments: Fixed a while ago.

Edited Issue: Doc: Solution Level Add Package Dialog [12]

Haacked — Wed, 24 Aug 2011 05:35:50 GMT

Need to document this. Perhaps as part of http://docs.nuget.org/docs/start-here/using-the-add-library-package-reference-dialog-box.