View source for Path of Diablo Wiki talk:About

== Welcome to the PoD Wiki ==

{| class="wikitable"
|<span style="color: brown">Anyone can login to their PoD account and edit the pages of this wiki. So please; if you see outdated or missing information, help us fix it. Thanks!</span>
|}
== Wiki To-Do ==
This page is meant to house a "to-do" list, in progress, and wish list for edits to the PoD Wiki

== Wiki editing documentation ==
Create a "how to" for wiki editing

Started [[Path_of_Diablo_Wiki_talk:About#Wiki_Editing | right here on this page.]]

Difficult to explain (and display!) in just text here, probably need good written documentation AND a video tutorial

== Bugs ==
Is a known bugs page helpful and needed? Or is it enough to list known bugs along with the skills that have them?

This would only really have 3 skills listed I think? Not sure an entire page dedicated to that is worth it. 

Who would have the capacity and bandwidth to maintain it?

== Class skill pages ==
Transition all class skills to the new display template/layout:
* Sorc, Druid, Paladin are all incomplete but in progress
* Amazon, Assassin, Necromancer, Barbarian have been adjusted for the new look
** '''Would be good for fresh eyes to look at it'''
* A few skills are missing display icons ([[Combat_Masteries#Pulverize|Pulverize]] and a couple of the [[Item-only_Skills|Item-only Skills]]; likely does not matter, but the lack of an icon stands out)

Go back through and change damage tables in skill pages to reflect up to lvl 40
* The format for this can be found on  [[Paladin_Combat_Skills#Sacrifice|'''Sacrifice''']] 
** It's one static table on the left, and one longer table with scroll bar on the right

== Aggregated class change page ==
[[Aggregated_Class_Changes | '''This page''']] has a lot of potential, should it be maintained?

== Item only skills ==
[[Item-only_Skills | Item-only skills page]]...

Page looks funny after converting these to the new look since they don't have the standard info

== Armor vs Armo'''u'''r ==
Shiver Armo/ur is spelled both ways in various places throughout the wiki, should be "Armor" with no U. Find and fix.

<span style="color: red"> '''Update:''' </span>Looks like '''Armor''' is the winner; this section will be deleted when that's complete.

== Nit picking ==
*Skill descriptions, do they all not end with a period? Are they statements or sentences?
**Same for patch notes listed in skill pages
*Are all prerequisite skill listed in '''not''' bold?
*Are all Skill-based synergies in bold?
*Are all attribute-based synergies (i.e. Dexterity or Intelligence) not in bold?
*Is spacing between sections on pages standard? Like, no extra white space?

== Wiki Editing ==
This section will provide a brief intro to editing the PoD wiki, with a focus on the formatting of skills.

For these examples, we'll be using [[Fire_Spells#Fire_Wall|Fire Wall]]. 

https://i.imgur.com/oDmwUwu.png

=== The skill descriptions ===

Using  [[Fire_Spells#Fire_Wall|Fire Wall]]  as an example, the existing skill descriptions look like this:

'''Description:''' Creates a wall of flame that blocks of burns your enemies.

'''Required Level:''' 18

'''Prerequisites:''' Blaze, Immolate

This is the code makes it appear like that:
<pre>
'''Description:''' Creates a wall of flame that blocks of burns your enemies.

'''Required Level:''' 18

'''Prerequisites:''' Blaze, Immolate
</pre>

''You'll notice that the words in '''bold''' have three single quotes (<nowiki>'''</nowiki>) surrounding them, this is the code formatting that makes characters bold in the wiki. ''

The modern standard for skill is to include a picture of the skill icon and clickable links in the list of prerequisites.
Still picking on [[Fire_Spells#Fire_Wall|Fire Wall]], the end product should look like this:

<!-- If skill doesnt exist in original Diablo 2 remove comment marks below -->
<!-- <span style="color:green">'''New skill'''</span>  -->
{|
|-
|
{| <!-- Description table -->
|rowspan="3" style="vertical-align:top; padding:0.5em 0.5em 0.5em 0.5em; width:5%"|https://pathofdiablo.com/wiki/images/sorceress/Fire%20Wall.png ||'''Description:''' Creates a wall of flame that blocks of burns your enemies'''
|-
|'''Required Level:''' 18
|-
|'''Prerequisites:'''  [[Fire_Spells#Blaze|Blaze]],  [[Fire_Spells#Immolate|Immolate]] 
|}
|-
|

The code to make this happen is a lot longer than the code to make the original happen, and it looks like this:
<pre>
{|
|-
|
{| <!-- Description table -->
|rowspan="3" style="vertical-align:top; padding:0.5em 0.5em 0.5em 0.5em; width:5%"|https://pathofdiablo.com/wiki/images/sorceress/Fire%20Wall.png ||'''Description:''' Creates a wall of flame that blocks of burns your enemies'''
|-
|'''Required Level:''' 18
|-
|'''Prerequisites:'''  [[Fire_Spells#Blaze|Blaze]],  [[Fire_Spells#Immolate|Immolate]] 
|}
|-
|</pre>

In that example, we have 4 pieces of information that will vary from skill to skill and need to be edited to reflect the skill: 
*The skill icon
*The skill description
*The level required for the skill
*Any prerequisites required
The labels for Description, Required Level, and Prerequisites are all in bold. 

The most obvious changes are the skills picture/icon and the clickable links in the prereq's list. All icons can be found here:
https://pathofdiablo.com/wiki/images/

In there you'll see a folder for every class, and all skill icons for that classes skills can be found in its folder. Adding the link to the [[Fire_Spells#Fire_Wall|Fire Wall]] icon includes the picture in the description. You'll see a "pipe" <nowiki>|</nowiki> character before the icon link and a double pipe ( <nowiki>||</nowiki> ) after it, as well as in various other places in the code. These pipes help control placement and formatting of text throughout the wiki pages and are necessary to make it appear the way it's supposed to.

The narrative skill description and level required are self explanatory, and generally I just copy the existing description from the old display into the new display.

For skill prerequisites, the standard is for clickable links to the skills. For [[Fire_Spells#Fire_Wall|Fire Wall]] to get [[Fire_Spells#Blaze|Blaze]] and [[Fire_Spells#Immolate|Immolate]] as clickable links instead of just text, we'll be using the <nowiki>[[Fire_Spells#Blaze|Blaze]],  [[Fire_Spells#Immolate|Immolate]]</nowiki> skill links in the code. To find copy/pasteable links to skills, navigate to the [[Main_Page | home page of the wiki]] and click on the relevant class link under the '''Character Attributes''' heading, and then click that classes Discussion tab. There, you'll see all that classes skills listed along with links that you can copy and paste. For this example we've been looking at sorceress skills, [[Talk:Sorceress|links for which can be found here.]]

Here's a short video about editing a skill description.
<youtube>https://youtu.be/M9hSpJGWgL8</youtube>