MusicBrainz Documentation: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
m (Yet more formatting changes.)
No edit summary
(25 intermediate revisions by 10 users not shown)
Line 1: Line 1:
==User documentation==
'''Status:''' ''We (well mostly [[User:Dupuy|Dupuy]]) are currently [[Restructuring The Documentation|RestructuringTheDocumentation]]; i.e. moving the MusicBrainzDocumentation from the main server into the Wiki. The docs on the homepage are often quite dated, so we will try to update and intertwingle them here. But '''this is work in progress''', so beware and read the status notices!''


;[[Frequently Asked Questions]]
Right now this page is roughly structured into docs for users, for developers and other. It would probably be better to have ''different'' structures that present the documentation. So I hereby invite everyone to invent and add categories likefor the following pages. Just go ahead and create some! We can sort it out later --[[User:DonRedman|DonRedman]]
: A set of community maintained FAQs.


===For the web interface===
==User Documentation==
;[[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]]
:Describes the different kinds of search you can use to browse MusicBrainz. Also includes the [[Indexed Search Syntax|advanced search syntax]].


;[[MusicBrainz Terminology]]
;[[MusicBrainz Terminology]]
:A collection of all terms the [[MusicBrainz]] community uses, what they mean, and wheter there is a wiki page explaining them.
:A collection of terms the MusicBrainz community uses, what they mean, and whether there is a wiki page explaining them.


===For the software===
;[[Release Language]]
;[https://picard-docs.musicbrainz.org/ Picard Documentation]
:Describes the assignement of the language and script attribute to releases.
:Documentation of [[MusicBrainz Picard]], MusicBrainz' official tagger.


===Other===
;[[Picard Documentation]]
;[[About/Privacy Policy|Privacy Policy]]
:Documentation of the [[Picard Tagger]], the next generation tagger in development.
:Privacy implications of being a MusicBrainz editor.

;[[How Annotations Work]]
:A rudimentary page that explains the [[Artist Annotation]] and [[Release Annotation]].

;[[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]]
''I am not sure how much of this stuff really belongs here. Some of it is probably better of in [[MusicBrainz Development]]. --[[User:DonRedman]]
:Catch-all page with a number of useful links for developers


===Software===
===Metadata===


;[[XML Web Service/Version 2]]
;[[Client HOWTO]]
:Our current-version web service, for use in applications
:Describes the use of [[libmusicbrainz]], and the [[Client Examples]] programs.


;[[XML Web Service/Version 1]]
===Discs===
:Our old web service, still in common use, e.g. by [[python-musicbrainz2]]


===Software===
;[[Disc Submission]]
:An overview of the highly technical content of [[Disc ID Calculation]]. (from cd_submission.html and disc.html)


;[[libmusicbrainz]]
===Tagging===
:Describes the use of our official library for accessing the web service. 4.x uses version 2, 3.x uses version 1.


;[[python-musicbrainz2]]
''The following pages are pretty messy, partially outdated, and make extensive use of [[Bad WikiName]]s.''
:Our now-somewhat-outdated official python library, see [http://python-musicbrainzngs.readthedocs.org/ python-musicbrainzngs] for a newer library.
;[[ID3v2.4.0]]
:Useful links for people wanting to use ID3v2 tags in applications.


===Discs===
;[[ID3v2 Tags]]
:A list of some TXXX tags for ID3v2 to toss about and try to "standardize".


;[[Disc IDs and Tagging]]
;[[Disc ID Calculation]]
:A short exposé on various tagging standards and their handling of [[Disc ID|DiscID]]s.
:An overview of the technical process of calculating [[Disc ID]]s.


;[[MusicBrainz Tag]]
;[[libdiscid]]
:C library for creating MusicBrainz DiscIDs from audio CDs. Much better than implementing Disc IDs yourself.
:Standardization for [[MusicBrainz]]-specific tags. (from metadata_tags.html)


===Tagging===
;[[MusicBrainz Identifier]]
:As used in standardized [[MusicBrainz Tag|MusicBrainzTag]]s. (from id-intro.html)

===Server===

;[[Auto-Insert From FreeDB]]
: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.


;[[MusicBrainz Picard/Tags/Mapping|Tag Mappings]]
Various [[Bug Reports]] and [[Feature Page|FeaturePage]]s and the like:
:These are the tag mappings used by [[MusicBrainz Picard]], our official tagging application
* [[Calculate Track Times]] (was [[Track Times Proposal]])
* [[Multi-Session CD Bug]]


===Database===
===Database===
Line 93: 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 08:56, 25 August 2020

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