Difference between revisions of "Path of Diablo Wiki talk:About"

Revision as of 19:29, 13 August 2023

Welcome to the PoD Wiki

Wiki To-Do

This page is meant to house a "to-do" list, in progress, and wish list for edits to the PoD Wiki

This page is NOT linked to anywhere

Wiki editing documentation

Create a "how to" for wiki editing

Started 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 with 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

Go back through and change damage tables in skill pages to reflect up to lvl 40

• The format for this can be found on Sacrifice
  • It's one static table on the left, and one longer table with scroll bar on the right

Aggregated class change page

This page has a lot of potential, should it be maintained?

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 Armour

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

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.

The skill descriptions

Using 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:

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

'''Required Level:''' 18

'''Prerequisites:''' Blaze, Immolate

You'll notice that the words in bold have three single quotes (''') 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 Wall, the end product should look like this:

Description: Creates a wall of flame that blocks of burns your enemies Required Level: 18 Prerequisites: Blaze, Immolate

The code to make this happen is a lot longer than the code to make the original happen, and it looks like this: {| |- | {| <!-- 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]] |} |- | 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 Wall icon includes the picture in the description. You'll see a "pipe" | character before the icon link and a double pipe ( || ) 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 Wall to get Blaze and Immolate as clickable links instead of just text, we'll be using the [[Fire_Spells#Blaze|Blaze]], [[Fire_Spells#Immolate|Immolate]] skill links in the code. To find copy/pasteable links to skills, navigate to the 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, links for which can be found here. Here's a short video about editing a skill description.