WikiDocs: Difference between revisions
Silentbird (talk | contribs) m (simplify language) |
|||
(One intermediate revision by one other user not shown) | |||
Line 1: | Line 1: | ||
Most of MusicBrainz's documentation is located at https://wiki.musicbrainz.org/ and transcluded at https://musicbrainz.org/doc/. |
|||
This |
This WikiDocs system works because: |
||
# |
# It leaves the wiki (and by extension, the documentation) open for mass collaboration. |
||
# |
# It lets [[Transclusion Editor|transclusion editors]] control what can be seen on the main site. |
||
== WikiDocs Structure == |
== WikiDocs Structure == |
||
⚫ | |||
{| class="wikitable" style="float: right; margin: 0 0 10px 10px" |
|||
⚫ | |||
|} |
|||
The structure of the WikiDocs system looks like this: |
The structure of the WikiDocs system looks like this: |
||
# |
# The content resides in the wiki, and anyone can edit and maintain it. |
||
# [[Transclusion Editor]]s add and update entries in the [ |
# [[Transclusion Editor|Transclusion editor]]s add and update entries in the [[mb:admin/wikidoc|transclusion table]] for official documentation pages. |
||
# Users visiting a page on the wiki see no difference; they always see the most recent revision of every page. |
# Users visiting a page on the wiki see no difference; they always see the most recent revision of every page. |
||
# Users visiting that same page on the main website will be shown, via transclusion, only the latest reviewed revision of that page |
# Users visiting that same page on the main website will be shown, via transclusion, only the latest reviewed revision of that page. |
||
Pages served via transclusion |
Pages served via transclusion cannot be edited on the website. |
||
==How To Transclude a WikiDocs Page== |
==How To Transclude a WikiDocs Page== |
||
'''Only transclusion editors |
'''Only transclusion editors can do this.''' |
||
: [[Image:Attention.png]] ''Please be very careful to enter the correct page name and revision number, they are '''not''' checked for correctness.'' |
: [[Image:Attention.png]] ''Please be very careful to enter the correct page name and revision number, because they are '''not''' checked for correctness.'' |
||
Go to the [ |
Go to the [[mb:admin/wikidoc|wiki transclusion table]]. Each page has its own row, which can be edited or removed. New rows can also be added. When a [[WikiDocs]] page has been edited, and the change conforms with the style guidelines and other social aspects — and most importantly, makes the documentation better — the change should be reflected on the main server. To do this, find the latest revision number using the page history and update it in the transclusion table. |
||
When adding a new page to the table, make sure to add it to the [[:Category:WikiDocs Page|WikiDocs page]] category. |
When adding a new page to the table, make sure to add it to the [[:Category:WikiDocs Page|WikiDocs page]] category. |
Latest revision as of 13:36, 23 January 2021
Most of MusicBrainz's documentation is located at https://wiki.musicbrainz.org/ and transcluded at https://musicbrainz.org/doc/.
This WikiDocs system works because:
- It leaves the wiki (and by extension, the documentation) open for mass collaboration.
- It lets transclusion editors control what can be seen on the main site.
WikiDocs Structure
The structure of the WikiDocs system looks like this:
- The content resides in the wiki, and anyone can edit and maintain it.
- Transclusion editors add and update entries in the transclusion table for official documentation pages.
- Users visiting a page on the wiki see no difference; they always see the most recent revision of every page.
- Users visiting that same page on the main website will be shown, via transclusion, only the latest reviewed revision of that page.
Pages served via transclusion cannot be edited on the website.
How To Transclude a WikiDocs Page
Only transclusion editors can do this.
Please be very careful to enter the correct page name and revision number, because they are not checked for correctness.
Go to the wiki transclusion table. Each page has its own row, which can be edited or removed. New rows can also be added. When a WikiDocs page has been edited, and the change conforms with the style guidelines and other social aspects — and most importantly, makes the documentation better — the change should be reflected on the main server. To do this, find the latest revision number using the page history and update it in the transclusion table.
When adding a new page to the table, make sure to add it to the WikiDocs page category.