# Adding docs for "Add release via Picard"
**URL:** https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059
**Category:** MusicBrainz
**Tags:** documentation, wiki, question, picard, musicbrainz
**Created:** [March 10, 2016, 2:40am UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059 "2016-03-10T02:40:56Z")
**Posts on this page:** 6
**Page:** 1
### Author:  [@Jim\_DeLaHunt](https://community.metabrainz.org/u/Jim_DeLaHunt)
#### Post date: [March 10, 2016, 2:40am UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059/1 "2016-03-10T02:40:56Z")
I had occasion to re-read [How to Add a Release](https://musicbrainz.org/doc/How_to_Add_a_Release). It’s really good information — it answered my immediate question — but I realised that it is missing the instructions how I add all of my entries for CDs.
What’s the process for improving documentation these days? Should I just be bold, and edit [How to Add a Release - MusicBrainz Wiki](https://wiki.musicbrainz.org/How_to_Add_a_Release) on the wiki? Who do I notify for review?
In case you are interested, this is what I think is missing:
I _always_ enter CDs by having Picard generate a [Disc ID](https://musicbrainz.org/doc/Disc_ID), then try to look it up in MusicBrainz. Sometimes MB has the Disc ID; usually, it doesn’t. So, I click the link for Add a Release, and then follow the four dialogues of Adding a Release. I like this because MusicBrainz knows all the track durations thanks to the Disc ID. Also, I get the Disc ID registered in MusicBrainz. Later, when I rip the CD, my ripper can retrieve accurate Release and Track titles via a Disc ID lookup.
There are instructions on [How to Add Disc IDs](https://musicbrainz.org/doc/How_to_Add_Disc_IDs). They mention in passing the Add a Release link. However, I don’t think that will inform a user looking for ways to add a release.
---
### Author:  [@Freso](https://community.metabrainz.org/u/Freso)
#### Post date: [March 10, 2016, 1:22pm UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059/2 "2016-03-10T13:22:46Z")
Perhaps it would be prudent to create an entirely new document on how to add a release via Picard? Could also include some documentation on how to use the “Add Cluster as Release” plugin. @CallerNo6?
---
### Author:  [@CallerNo6](https://community.metabrainz.org/u/CallerNo6)
#### Post date: [March 10, 2016, 4:20pm UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059/3 "2016-03-10T16:20:49Z")
> [@Freso](#):
>
> Perhaps it would be prudent to create an entirely new document on how to add a release via Picard?
Yeah, I’d like to see this workflow described in the wiki and then have a link to that added to [Picard docs](http://picard.musicbrainz.org/docs/). I don’t see anything in the Picard FAQ about “what if my release isn’t in MB yet?”. (Maybe it’s there and I’m simply not seeing it?)
@Jim_DeLaHunt, yes, [Be Bold](https://en.wikipedia.org/wiki/Wikipedia:Be_bold) applies to the [How To](https://wiki.musicbrainz.org/Category:How_To)s. The Picard docs, meanwhile, are static pages on [GitHub](https://github.com/metabrainz/picard-website/tree/master/website/frontend/templates/docs).
---
### Author:  [@Jim\_DeLaHunt](https://community.metabrainz.org/u/Jim_DeLaHunt)
#### Post date: [March 10, 2016, 5:36pm UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059/4 "2016-03-10T17:36:14Z")
> [@Freso](#):
>
> …create an entirely new document on how to add a release via Picard?
I think we’ll end up needing multiple articles to explain everything, yes. But rather than framing the documents around tools (“this is how you use Picard to add a release”), we should frame them around user goals and situations (“you have a CD and want to add that release to MB, here’s how to use Picard to do it”).
> [@Freso](#):
>
> …also include some documentation on how to use the “Add Cluster as Release” plugin.
I’d frame this as “you have a set of music files that make up an album, and you want to add that release to MB, here’s how to use Picard to do it”.
---
### Author:  [@Jim\_DeLaHunt](https://community.metabrainz.org/u/Jim_DeLaHunt)
#### Post date: [March 10, 2016, 5:37pm UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059/5 "2016-03-10T17:37:09Z")
> [@CallerNo6](#):
>
> yes, Be Bold applies to the How Tos.
Thank you @CallerNo6, I’ll be bold.
---
### Author:  [@Freso](https://community.metabrainz.org/u/Freso)
#### Post date: [March 13, 2016, 10:02am UTC](https://community.metabrainz.org/t/adding-docs-for-add-release-via-picard/2059/6 "2016-03-13T10:02:16Z")
A post was split to a new topic: [Adding DiscIDs before ripping](https://community.metabrainz.org/t/adding-discids-before-ripping/4359)