New NuGet Documentation Site

nuget, open source 0 comments suggest edit

It’s a common refrain you hear when it comes to documentation for open source projects. It typically sucks! In part, because nobody wants to work on docs. But also in part because good documentation is challenging to write.

What is good documentation in the first place? The following is a list of some qualities that make for great documentation. This list is by no means complete. Good docs are…

  • Written for the right audience
  • Comprehensive and accurate
  • Easily browsable and searchable
  • Written in a clear and concise language
  • Laid out in a readable format
  • Versioned with the source code

While it’s challenging to write and maintain great documentation, my co-worker Matthew was up to the challenge of building a simple Markdown based system to help us manage our documentation. Read about our new docs site in his blog post, Introducing NuGet Docs: Community Driven Documentation.

Our goal in the long run is to have a great set of docs for NuGet with help from the community. So if you’re interested in helping out, please visit our NuGet Docs project page and let us know. It’s a separate repository with its own Mercurial repository so we can give a lot more people write access directly to the repository.

So please, if you’re looking for a low commitment easy way to get a toe in the waters with open source in general or with NuGet, consider helping us with our docs. It’s a great way to get started with OSS. It’s how I got my start a long time ago by contributing docs to RSS Bandit.

Found a typo or error? Suggest an edit! If accepted, your contribution is listed automatically here.



3 responses

  1. Avatar for Tjaart
    Tjaart May 11th, 2011

    Excellent timing as today I am going to integrate NuGet support into my product.
    One topic that I haven't found much information on is hosting a writable NuGet feed that will allow users to publish their packages, similar to the official NuGet backend.
    This will be very useful for commercial applications or hosting a private service within a company.

  2. Avatar for crsplace
    crsplace May 16th, 2011

    ya very usefull applications great documentation.

  3. Avatar for TripleEmcoder
    TripleEmcoder May 22nd, 2011

    @Tjaart: if you're willing to go through quite a few steps of setting it all up, you can launch your own NuGet Gallery in about half a day with these instructions: