Writing Guidelines for New Contributors

Discussion's surrounding the official Freezenet Wiki.

Moderators:Moderator, Discussion Moderator

Locked
IceCube
Site Admin
Posts:1210
Joined:Fri Aug 03, 2018 3:30 am
Contact:
Writing Guidelines for New Contributors

Post by IceCube » Wed Apr 15, 2020 3:19 am

This post is intended for new contributors who are trying to feel their way around the Wiki and are looking for general guidance. This post will also be updated as more information becomes clear. For now, this guide is meant to help with the code learning as well as figure out how to contribute to the Wiki.

Determining RIAA Status

The Recording Industry Association (RIAA) is a large organization of record labels. Given their history with how they treat websites and individuals, there are very specific rules regarding how to handle their content.

The first step is to determine whether or not the music you have is RIAA-related or not. The method I've been personally using is to look up the label on Wikipedia (here). If it's not on the list, I then go to stage to of determining the RIAA affiliation. I simply look up the label and determine either who owns the label or what label is the parent label. If there is secondary ownership, then I determine if that ownership is a member on that list. If not, then the music gets an all-clear.

If The Music is RIAA

If it is determined that the music in question is RIAA related, that doesn't necessarily mean that it is banned from the Wiki at all. Instead, the music simply has to be treated very differently. For instance, if you are writing a release page on RIAA related music and including an availability section, do NOT embed the music to video or audio sharing platforms. If the music is officially posted on social media, simply leave a link if you have to or do not link it at all. Ideally, just link to the official pages where you can buy or legally stream the music (think Spotify).

If The Music is Not RIAA

If you determine that the music is not related to RIAA, then the restrictions are loosened. If the music is, say, posted to YouTube by either the artist or the label, then you are free to embed it. If it is posted by a random user, then do not embed or link to it.

Radio Shows or Podcasts

If the music in the show is predominantly RIAA music, then don't embed the show. If the show, say, contains the odd bootleg here or there of an RIAA release, then you can let that slide and embed it. If the show is officially released, default to embedding or linking to the official release. Also, leave a link below because some sites like YouTube restricts playback on third party sites. If the show is RIAA, you can list off what was played, what is in a top list, etc., but that is largely it.

If the show is discontinued and no longer supported and it is pre-dominantly non-RIAA for the most part overall, then you can link and embed third party uploads from other users. At that point, this is a question of preservation more than anything else.

Show Indexes

Ideally, you'll want to have a show index to house all of the shows. This allows users to look at the show at a glance. You can start the page with the following code:

Code: Select all

[[category:[GENRE] Shows]]

[[File:[IMAGE.EXT]|250px|thumb|right|[INSERT DESCRIPTION HERE]]
The above code will not only generate a thumbnail on the right hand side of the page, but also allow you to define a general genre category as well. Keep the genre's general (i.e. Trance, Drum N Bass, House, Rock, etc.)

The code for the tables is not that big of a deal, but a royal pain to create the first time. To save times for podcasts, you can simply borrow this block of code:

Code: Select all

{| class="wikitable"
|-
! 0XX !! X0 !! X1 !! X2 !! X3 !! X4 !! X5 !! X6 !! X7 !! X8 !! X9
|-
! scope="row"| 0X
| 000 || 001 || 002 || 003 || 004 || 005 || 006 || 007 || 008 || 009
|-
! scope="row"| 1X
| 010 || 011 || 012 || 013 || 014 || 015 || 016 || 017 || 018 || 019
|-
! scope="row"| 2X
| 020 || 021 || 022 || 023 || 024 || 025 || 026 || 027 || 028 || 029
|-
! scope="row"| 3X
| 030 || 031 || 032 || 033 || 034 || 035 || 036 || 037 || 038 || 039
|-
! scope="row"| 4X
| 040 || 041 || 042 || 043 || 044 || 045 || 046 || 047 || 048 || 049
|-
! scope="row"| 5X
| 050 || 051 || 052 || 053 || 054 || 055 || 056 || 057 || 058 || 059
|-
! scope="row"| 6X
| 060 || 061 || 062 || 063 || 064 || 065 || 066 || 067 || 068 || 069
|-
! scope="row"| 7X
| 070 || 071 || 072 || 073 || 074 || 075 || 076 || 077 || 078 || 079
|-
! scope="row"| 8X
| 080 || 081 || 082 || 083 || 084 || 085 || 086 || 087 || 088 || 089
|-
! scope="row"| 9X
| 090 || 091 || 092 || 093 || 094 || 095 || 096 || 097 || 098 || 099
|}

Code: Select all

{| class="wikitable"
|-
! 1XX !! X0 !! X1 !! X2 !! X3 !! X4 !! X5 !! X6 !! X7 !! X8 !! X9
|-
! scope="row"| 0X
| 100 || 101 || 102 || 103 || 104 || 105 || 106 || 107 || 108 || 109
|-
! scope="row"| 1X
| 110 || 111 || 112 || 113 || 114 || 115 || 116 || 117 || 118 || 119
|-
! scope="row"| 2X
| 120 || 121 || 122 || 123 || 124 || 125 || 126 || 127 || 128 || 129
|-
! scope="row"| 3X
| 130 || 131 || 132 || 133 || 134 || 135 || 136 || 137 || 138 || 139
|-
! scope="row"| 4X
| 140 || 141 || 142 || 143 || 144 || 145 || 146 || 147 || 148 || 149
|-
! scope="row"| 5X
| 150 || 151 || 152 || 153 || 154 || 155 || 156 || 157 || 158 || 159
|-
! scope="row"| 6X
| 160 || 161 || 162 || 163 || 164 || 165 || 166 || 167 || 168 || 169
|-
! scope="row"| 7X
| 170 || 171 || 172 || 173 || 174 || 175 || 176 || 177 || 178 || 179
|-
! scope="row"| 8X
| 180 || 181 || 182 || 183 || 184 || 185 || 186 || 187 || 188 || 189
|-
! scope="row"| 9x
| 190 || 191 || 192 || 193 || 194 || 195 || 196 || 197 || 198 || 199
|}

Code: Select all

{| class="wikitable"
|-
! 2XX !! X0 !! X1 !! X2 !! X3 !! X4 !! X5 !! X6 !! X7 !! X8 !! X9
|-
! scope="row"| 0X
| 200 || 201 || 202 || 203 || 204 || 205 || 206 || 207 || 208 || 209
|-
! scope="row"| 1X
| 210 || 211 || 212 || 213 || 214 || 215 || 216 || 217 || 218 || 219
|-
! scope="row"| 2X
| 220 || 221 || 222 || 223 || 224 || 225 || 226 || 227 || 228 || 229
|-
! scope="row"| 3X
| 230 || 231 || 232 || 233 || 234 || 235 || 236 || 237 || 238 || 239
|-
! scope="row"| 4X
| 240 || 241 || 242 || 243 || 244 || 245 || 246 || 247 || 248 || 249
|-
! scope="row"| 5X
| 250 || 251 || 252 || 253 || 254 || 255 || 256 || 257 || 258 || 259
|-
! scope="row"| 6X
| 260 || 261 || 262 || 263 || 264 || 265 || 266 || 267 || 268 || 269
|-
! scope="row"| 7X
| 270 || 271 || 272 || 273 || 274 || 275 || 276 || 277 || 278 || 279
|-
! scope="row"| 8X
| 280 || 281 || 282 || 283 || 284 || 285 || 286 || 287 || 288 || 289
|-
! scope="row"| 9x
| 290 || 291 || 292 || 293 || 294 || 295 || 296 || 297 || 298 || 299
|}
At the end of, well, any page, you can simply paste the following block of code:

Code: Select all

== References ==

<references />
This will create a nice banner and house all the references you've used in the page above.

Generating Pages

Generating pages in Wiki works a bit differently than most sites. Most CMS's and sites have you create a new page in an editor, then publish them. In Wiki, however, it asks you to create a link to a non-existent page first. From there, you click on the red link and create the page. If there are no obvious references anywhere else on the page, you can make temporary reference to it on the main genre's page. While somewhat backwards, this does seem to prevent orphaned pages from cropping up.

Linking

To link to a page, take this sentence as an example:
The artist, Sean Tyas, created a radio show.
Now, I want to hot-link Sean Tyas. To do so, we add two square brackets to the name link so:

Code: Select all

The artist, [[Sean Tyas]], created a radio show.
This is a good first step, but some URLs simply aren't this clean. Let's take this sentence for example:
Tyas created a label called Regenerate Records
We can't simply put the square brackets around it because it would not be a proper link. Instead, we need to customize the link to have custom text. To do so, we simply change the sentence to have the following:

Code: Select all

Tyas created a label called [[Regenerate Records (Label)|Regenerate Records]]
Note the pipe that separates the URL and the text of the link. You need the full page name before the pipe for proper linking. Anything after the pipe will allow you insert whatever text is necessary to allow the sentence to flow.

IceCube
Site Admin
Posts:1210
Joined:Fri Aug 03, 2018 3:30 am
Contact:

Re: Writing Guidelines for New Contributors

Post by IceCube » Wed Apr 15, 2020 4:01 am

External Linking

Sometimes, you need to directly link to an external website. Let's take this sentence for example:
You can check out Freezenet here.
External linking simply requires the use of a single square bracket. So, the proper way to do this is with the following code:

Code: Select all

You can check out Freezenet [https://www.freezenet.ca here].
Note that you do NOT need a pipe to separate the URL and the custom text. All you need is a simple space and to end the linked text with a closing square bracket.

References

Like other Wiki's, Freezenet utilizes references in the pages themselves. To reference something, simply pick the last part of the text you want to reference and insert the reference you want to make. For example:
Freezenet also wrote an official review of this release.
To add a reference at the end of this sentence, we just add the following code:

Code: Select all

<ref name="Freezenet Review">[https://www.freezenet.ca/review-mike-foyle-pandora-original-mix-progressive-trance/ Mike Foyle - Pandora (Original Mix)]</ref>
So, the full result is this:

Code: Select all

Freezenet also wrote an official review of this release.<ref name="Freezenet Review">[https://www.freezenet.ca/review-mike-foyle-pandora-original-mix-progressive-trance/ Mike Foyle - Pandora (Original Mix)]</ref>
The ref name (in quotes) can be anything. The biggest thing to remember is that the name cannot match any other name on the page itself. You can use the same name on different pages, but just avoid conflicts within the page itself. After that, you can paste simple URL's or even reference comments if you like. Just remember to add the closing tag. Yes, this uses angle brackets for that added bit of confusion. If you do this successfully, then all you'll get in the final page is a number next to the sentence and the information will appear at the bottom of the page.

Info Boxes

Info boxes are generally custom made and require built-in templates to work. The Freezenet Wiki uses templates. An artist page is a pretty simply template:

Code: Select all

{{Artist|Above & Beyond|[[File:Above_and_Beyond_artist.jpeg|250px|thumb|center|Group photo of Above & Beyond]]|Paavo Siljamäki, Jono Grant, Tony McGuinness|UK|[https://www.aboveandbeyond.nu/ aboveandbeyond.nu]}}
The above code was taken from the Above & Beyond page: https://www.freezenet.ca/wiki/index.php ... %26_Beyond

I'll strip out all the custom code below so you can see what can be customized:

Code: Select all

{{Artist|[INSERT ARTIST NAME HERE]|[[File:[INSERT IMAGE NAME HERE]|250px|thumb|center|[INSERT IMAGE COMMENT HERE]]]|[INSERT GROUP MEMBERS HERE]|[INSERT COUNTRY HERE]|[INSERT OFFICIAL URL HERE]}}
You can use the above code if you need an info-box on an artist page.

For labels, the template is very similar:

Code: Select all

{{Label|[INSERT LABEL HERE]|[[File:[INSERT IMAGE NAME HERE]|250px|thumb|center|[INSERT IMAGE COMMENT HERE]]]|[INSERT FOUNDING ARTIST HERE]|[INSERT YEAR FOUNDED HERE]|[INSERT COUNTRY OF ORIGIN FOR THE LABEL HERE]|[INSERT ACTIVITY STATUS HERE]|[INSERT OFFICIAL URL HERE]|[INSERT PARENT LABEL HERE]|[IF RIAA RELATED, USE  {{Redyes}}, OTHERWISE, USE {{Greenno}}]]|}}
For individual shows, you can use this code for your info-box:

Code: Select all

{{Show|[[[INSERT SHOW NAME HERE]]]|[[File:[INSERT IMAGE NAME HERE]|250px|thumb|center|[INSERT COMMENT ABOUT IMAGE HERE]]]|[INSERT IF RADIO OR PODCAST SHOW HERE]|[INSERT POSTING DATE OR AIRING DATE HERE]|[INSERT EPISODE NUMBER HERE]|[[[INSERT DJ NAME HERE]]]|[INSERT GENRE HERE]|[INSERT STYLE HERE]|[INSERT IF A MIXED SHOW OR JUST A CHART SHOW HERE]|[INSERT PREVIOUS EPISODE NUMBER HERE OR "First Episode" IF IT'S FIRST EPISODE HERE]|[INSERT NEXT EPISODE HERE (IF LAST EPISODE, YOU CAN JUST TYPE |Last episode")]|[INSERT OFFICIAL PAGE FOR SHOW HERE OR "Offline" IF NOT AVAILABLE}}

IceCube
Site Admin
Posts:1210
Joined:Fri Aug 03, 2018 3:30 am
Contact:

Re: Writing Guidelines for New Contributors

Post by IceCube » Wed Apr 15, 2020 4:14 am

Other Tables

As you know, there are other tables on the Wiki. For individual shows, you can use this block of code:

Code: Select all

{| class="wikitable"
|-
! Track Number !! Time Stamp !! Artist !! Title !! Mix/Remix !! Record Label
|-
| [INSERT TRACK NUMBER HERE]|| [INSERT TIME STAMP HERE] || [INSERT ARTIST OR ARTISTS HERE] || [INSERT TITLE NAME HERE] || [INSERT MIX, REMIX, VERSION HERE. IF IT'S THE ORIGINAL, YOU CAN SIMPLY TYPE "Original Mix"] || [INSERT RECORD LABEL HERE IF APPLICABLE]
|}
Note the pipe and closed curly bracket at the end of the table. This closes the table and is required at the end. If you want to add another line, simply create another line, then add this code:

Code: Select all

|-
This code tells Wiki to add another row in the table.

In the next line, add another pipe and then add your next line.

Album Discography tables operate similarly:

Code: Select all

{| class="wikitable"
|-
! Artist(s) !! Title !! Year !! Type !! Catalogue Number
|-
| [INSERT ARTIST NAME HERE OR "V/A" IF COMPILATION] || [INSERT RELEASE TITLE HERE] || [INSERT RELEASE YEAR HERE] || [INSERT IF A SINGLE, EP, COMPILATION, ALBUM, OR OTHER TYPE OF RELEASE HERE] || [INSERT CATALOGUE NUMBER HERE IF AVAILABLE]
|}
Finally, artist discography tables:

Code: Select all

{| class="wikitable"
|-
! Title !! Year !! Label
|-
| [INSERT TITLE OF RELEASE HERE] || [INSERT RELEASE YEAR HERE] || [INSERT LABEL HERE]
|}
Embedding Media

To embed something from YouTube, you can simply use the following code:

Code: Select all

<youtube>[INSERT YOUTUBE URL HERE]</youtube>
For Soundcloud and other services, you can use the following code:

Code: Select all

{{#evt:
service=soundcloud(REPLACE IF OTHER SERVICE IS BEING USED)
|id=[INSERT FULL URL HERE]
|dimensions="[x150]"
}}
The Wiki does not support Podbay or Mixcloud, sorry. In those cases, you'll just have to leave a direct link.

Also, remember to add a direct link to the page below the embedded media. This is to assist in usability in the event the embedding is blocked on thirst party sites.

Other Formatting

Headings can easily be applied with this code:

Code: Select all

== [INSERT HEADING HERE] ==
Subheadings are added by adding equal signs on either side:

Code: Select all

=== [INSERT HEADING HERE] ===
Bold-faced text can be added with three single quotations:

Code: Select all

'''Bold Text'''
I hope this helps you in your coding. More will be added if anything else comes up. :)

IceCube
Site Admin
Posts:1210
Joined:Fri Aug 03, 2018 3:30 am
Contact:

Re: Writing Guidelines for New Contributors

Post by IceCube » Wed Apr 15, 2020 7:30 pm

Page Naming Conventions

One of the problems with covering music is that there is a lot of overlap between names. What the Freezenet Wiki has in place is a method of differentiating between same names.

For labels, the general naming convention is this:
label name (Label)
This will prevent label names from conflicting with other kinds of content like artist names or song titles. If we run into the problem of two labels having the same name, there are two ways to differentiate the two: main genre they cover or their country of origin. So, those examples might look something like this:
Label Name (Label) (Genre)
Label Name (Label) (Country)
Label Name (Label) (Genre) (Country)
Ideally, I think we should try and stick with genre first. If a genre page is already used, then we can look at country. If both are used, then we'll resort to using both. Additionally, if we run into any conflicts, a disambiguous page will also be created to help guide people in the situations they came across the wrong page by accident.

Singles and albums will use the parenthesis and always include the artist name at least. There are WAY too many identically named releases out there to not start doing this from the getgo. So, the naming convention looks something like this:
Release Title (Artist Name)
If we run into a release title having the same artist name, then we add the genre at the end. Of course, like the label name, we can also fall back on country name and both as a last resort. Any overlap should result in both pages referencing the disambiguous page.

In the event that there is a naming conflict, you can differentiate by genre first. If that is somehow unavailable, then use the artists country. You can use both if neither options are available.

As for artists, ideally, the bigger name artist will get the plain URL. Otherwise, it's a case of whoever gets mentioned first. When conflicts happen, you can try differentiating by real name of one of the members name. So, let's take Above & Beyond as an example. If there was another artist who already took up that name, then I would name the page something like this:
Above & Beyond (Paavo)
As it's a group, I can use any first name at my disposal. Otherwise, and if it makes more sense, we can also go by genre, then name. Use of country or origin would be a last resort.

IceCube
Site Admin
Posts:1210
Joined:Fri Aug 03, 2018 3:30 am
Contact:

Re: Writing Guidelines for New Contributors

Post by IceCube » Wed Apr 15, 2020 8:14 pm

Known Problems

If you add a page with a category, the page will display the category name. If you go to the categories page, it will appear as though it has updated. This will be the case for all logged in users. However, if you view the page while logged out, the new pages may suddenly disappear. This appears to be a caching issue. When you have done all your updates for the day, you can go to the categories page, then click on History. You'll see at the end of the URL the following:
&action=history
From there, edit the end of the URL to show the following:
&action=purge
When you hit enter, you'll be asked if you want to clear the cache. Click "Yes" and the cache will be purged. After that, updates will appear for all users, not just logged in users.

This issue doesn't seem to affect regular pages that we are aware of, but if you do run into similar problems, this is an option.

Disallowed Content

For releases, lyrics for the track is not allowed. Lyrics are technically copyrighted material. As a result, I ask you to please, if the lyrics are something you think should be added, offer a summary of the lyrics. An example would be something like this:
The song lyrics talk about the family dog. Some interpret them as how great life was with the dog while others interpret it as how loss affects people.
Extreme violence, nudity, or illegal content depicted in imagery. Some album or release covers contain this kind of content. If there is a SFW version of the album cover somewhere, use that instead. In the event that a SFW version is not available, you can edit the art by using the Freezenet official logo as a censor bar. You are certainly free to talk about the contents of the NSFW aspects of the art in a factual manner, but ideally we probably don't want to be showing it.

I know what it's like to be an artist. I see people talk about their work and how there are such things as tasteful nudity. I personally don't have any real qualms with tasteful nudity, but the last thing I want to do is test the patience of my web host. So, unless it's a statue we're talking about, ideally, we want to look at trying to keep things as G-rated as possible. When in doubt, cover up.

Locked