MusicBrainz Documentation: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(Removing crud from eons past.)
m (Typo)
(23 intermediate revisions by 9 users not shown)
Line 1: Line 1:
==User Documentation==
==User documentation==

;[[Frequently Asked Questions]]
: A set of community maintained FAQs.

===For the web interface===
;[[About]] and [[Beginners Guide]]
:A quick introduction to MusicBrainz and to its use, respectively.


;[[How To]]s
;[[How To]]s
:A collection of tutorials. Lightweight, short and user-orientated step by step instructions.
:A collection of tutorials. Lightweight, short and user-orientated step by step instructions.


;[[Introduction to Editing]]
;[[How Editing Works]] and the different [[Edit Type]]s
:A general introduction and detailed descriptions of each type of edit that you can possibly make to [[MusicBrainz]] data.
:A quick introduction to how changes to MusicBrainz data are made.


;[[Introduction to Voting]]
;[[Advanced Relationships]]
:A quick introduction to MusicBrainz's voting system and how edits are applied (or rejected).
:The [[Advanced Relationships]] documentation and the list of [[Advanced Relationship Type]]s.


;[[Advanced Search]]
;[[Style|Style guidelines]]
:All our official guidelines for editing.
:Describes the server-based search (also used by the [[MusicBrainz Tagger]]).


;[[Search]]
;[[MusicBrainz Terminology]]
:Describes the different kinds of search you can use to browse MusicBrainz. Also includes the [[Indexed Search Syntax|advanced search syntax]].
:A collection of all terms the [[MusicBrainz]] community uses, what they mean, and wheter there is a wiki page explaining them.


;[[Release Language]]
;[[MusicBrainz Terminology]]
:A collection of terms the MusicBrainz community uses, what they mean, and whether there is a wiki page explaining them.
:Describes the assignement of the language and script attribute to releases.


===For the software===
;[[Picard Documentation]]
;[[Picard Documentation]]
:Documentation of the [[Picard Tagger]], the next generation tagger in development.
:Documentation of [[MusicBrainz Picard]], MusicBrainz' official tagger.


===Other===
;[[How Annotations Work]]
;[[About/Privacy Policy|Privacy Policy]]
:A rudimentary page that explains the [[Artist Annotation]] and [[Release Annotation]].
:Privacy implications of being a MusicBrainz editor.

;[[How Voting Works]]
:Also quite rudimentary. It explains the decision mechanism of the [[ModBot]].

;[[Editor Privacy]]
:Privacy implications of being a [[MusicBrainz]] editor.

;[[Text Search Syntax]]
:How to use the powerful text search features in [[MusicBrainz]]


;[[Flickr Machine Tag]]
;[[Flickr Machine Tag]]
:How to use flickr tags to refer to [[MusicBrainz]] artists, releases, tracks or labels.
:How to use flickr tags to refer to MusicBrainz artists, releases, tracks or labels.


==Developer Documentation==
==Developer Documentation==


;[[Developer Resources]]
===Software===
:Catch-all page with a number of useful links for developers


===Metadata===
;[[Client HOWTO]]
:Describes the use of [[libmusicbrainz]], and the [[Client Examples]] programs.


;[[XML Web Service/Version 2]]
===Discs===
:Our current-version web service, for use in applications


;[[XML Web Service/Version 1]]
;[[Disc Submission]]
:Our old web service, still in common use, e.g. by [[python-musicbrainz2]]
:An overview of the highly technical content of [[Disc ID Calculation]]. (from cd_submission.html and disc.html)


===Tagging===
===Software===


;[[ID3v2.4.0]]
;[[libmusicbrainz]]
:Describes the use of our official library for accessing the web service. 4.x uses version 2, 3.x uses version 1.
:Useful links for people wanting to use ID3v2 tags in applications.


;[[ID3v2 Tags]]
;[[python-musicbrainz2]]
:Our now-somewhat-outdated official python library, see [http://python-musicbrainzngs.readthedocs.org/ python-musicbrainzngs] for a newer library.
:A list of some TXXX tags for ID3v2 to toss about and try to "standardize".


===Discs===
;[[Disc IDs and Tagging]]
:A short exposé on various tagging standards and their handling of [[Disc ID|DiscID]]s.


;[[Disc ID Calculation]]
;[[MusicBrainz Tag]]
:An overview of the technical process of calculating [[Disc ID]]s.
:Standardization for [[MusicBrainz]]-specific tags. (from metadata_tags.html)


;[[libdiscid]]
;[[MusicBrainz Identifier]]
:C library for creating MusicBrainz DiscIDs from audio CDs. Much better than implementing Disc IDs yourself.
:As used in standardized [[MusicBrainz Tag|MusicBrainzTag]]s. (from id-intro.html)


===Server===
===Tagging===


;[[MusicBrainz Picard/Tags/Mapping|Tag Mappings]]
;[[Auto-Insert From FreeDB]]
:These are the tag mappings used by [[MusicBrainz Picard]], our official tagging application
:Explains how data is automatically entered as [[FreeDB Moderation|FreeDBModeration]]s .

;[[Server Access Paths]]
:Explains the various "fixed" ways into the [[MusicBrainz]] [[Server]].

;[[Release Editor Arguments]]
:Explains the arguments to pre-populate the fields in the release editor.

Various [[Bug Reports]] and [[Feature Page|FeaturePage]]s and the like:
* [[Calculate Track Times]] (was [[Track Times Proposal]])
* [[Multi-Session CD Bug]]


===Database===
===Database===
Line 86: Line 76:
:Start page for documentation about the database.
:Start page for documentation about the database.


;[[Panther DB Installation]]
;[[Database Schema]]
:Description of our current schema and database structure.
:Steps to intall PostgreSQL and import [[MusicBrainz]] data on Mac OS X 10.3 aka Panther.


;[[Debian VMWare Database]]
;[[Database Setup]]
:Several ways of setting up and using our database.
:HOWTO install the database under Debian running under VMWare.


==Other Documentation==
==Other Documentation==


;[[Other Databases]]
* [http://solution.itagent.ne.jp/sw/voca10.html Japanese documentation for MusicBrainz Metadata Initiative 2.1]
* [[Other Databases]] -- Other music databases which we might try to work with
:Other music databases which we might try to work with

* [[Links To Free Creative Commons License Music]]
* [[MusicBrainz Summit]]s
;[[MusicBrainz Summit]]s


[[Category:To Be Reviewed]] [[Category:Documentation Something]]
[[Category:Documentation]] [[Category:To Be Reviewed]] [[Category:WikiDocs Page]]

Revision as of 15:55, 27 September 2019

User documentation

Frequently Asked Questions
A set of community maintained FAQs.

For the web interface

About and Beginners Guide
A quick introduction to MusicBrainz and to its use, respectively.
How Tos
A collection of tutorials. Lightweight, short and user-orientated step by step instructions.
Introduction to Editing
A quick introduction to how changes to MusicBrainz data are made.
Introduction to Voting
A quick introduction to MusicBrainz's voting system and how edits are applied (or rejected).
Style guidelines
All our official guidelines for editing.
Search
Describes the different kinds of search you can use to browse MusicBrainz. Also includes the advanced search syntax.
MusicBrainz Terminology
A collection of terms the MusicBrainz community uses, what they mean, and whether there is a wiki page explaining them.

For the software

Picard Documentation
Documentation of MusicBrainz Picard, MusicBrainz' official tagger.

Other

Privacy Policy
Privacy implications of being a MusicBrainz editor.
Flickr Machine Tag
How to use flickr tags to refer to MusicBrainz artists, releases, tracks or labels.

Developer Documentation

Developer Resources
Catch-all page with a number of useful links for developers

Metadata

XML Web Service/Version 2
Our current-version web service, for use in applications
XML Web Service/Version 1
Our old web service, still in common use, e.g. by python-musicbrainz2

Software

libmusicbrainz
Describes the use of our official library for accessing the web service. 4.x uses version 2, 3.x uses version 1.
python-musicbrainz2
Our now-somewhat-outdated official python library, see python-musicbrainzngs for a newer library.

Discs

Disc ID Calculation
An overview of the technical process of calculating Disc IDs.
libdiscid
C library for creating MusicBrainz DiscIDs from audio CDs. Much better than implementing Disc IDs yourself.

Tagging

Tag Mappings
These are the tag mappings used by MusicBrainz Picard, our official tagging application

Database

MusicBrainz Database
Start page for documentation about the database.
Database Schema
Description of our current schema and database structure.
Database Setup
Several ways of setting up and using our database.

Other Documentation

Other Databases
Other music databases which we might try to work with
MusicBrainz Summits