Difference between revisions of "Helping Out"

From Abidan Archive Wiki
Jump to navigation Jump to search
(38 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
All wiki contributors are welcome and greatly appreciated, here you will find information on priority work, style guides and long term projects. To get approved for editing please contact one of our moderators, [[User:LilBlue|LilBlue]] or [[User:TransEmo|TransEmo]] who can set up your permissions. Thank you so much, we really appreciate it!{{Quote Box|title=Relevant Plea|quote=''"We need more wiki contributors"''|source=-Maadrast|align=left}}
 
__NOTOC__
 
__NOTOC__
All wiki contributors are welcome and greatly appreciated, here you will find information on priority work, style guides and long term projects. To get approved for editing please contact one of our moderators, [[User:LilBlue|LilBlue]] or [[User:TransEmo|TransEmo]] who can set up your permissions. Thank you so much, we really appreciate it!
 
  
  
==Helping out==
+
<br>
If you have a little time to spare: the wiki is plagued with errors, and any assistance would be much appreciated in this especially. Here is a quick list of common errors on the wiki:
+
 
{| class="article-table"
+
 
 +
 
 +
<br />
 +
 
 +
==What to work on?==
 +
 
 +
===New Pages and Completing half finished ones===
 +
The Abidan Archives are organized in a tree format following the guides lain out in the bubble tree linked below.
 +
<div style="text-align: center; font-size: 150%;">
 +
[https://miro.com/app/board/o9J_kxpflKM=/ Wiki Structure Guide]
 +
 
 +
</div>This map guides the overall organization of the wiki and is periodically updated to reflect the completeness of any given page. If you are looking to add new pages to the wiki or complete unfinished ones this is a good place to start. Pages on the map are categorized in one of four ways.
 +
 
 +
*'''Purple:''' These are Priority Pages, these pages have been deemed important but either empty or unfinished. If you can, these are the most important pages to work on.
 +
*'''White:''' These are simply empty pages, many of these pages are linked too from others but have no content, you can easily navigate to one of these pages and start filling them out.
 +
*'''Yellow:''' These are half finished pages, there is some content here but it either needs to be updated after a new release, or finished if it simply does not contain all of the necessary info.
 +
*'''Green:''' These are finished pages! One day all of the pages will be green! Some of these pages may still need updating if they have fallen behind, but they are pretty solid and don't need much work.
 +
 
 +
If you find any errors in the map, or you have updated something you can contact [[User:Maadrast|Maadrast]] who supposedly maintains it, or make an account and edit it yourself.
 +
*Note — this map/tree Maadrast made is excellent, but it’s out of date. I have completed many of the pages, highlighted on the map in purple, white, or yellow. So check around to see if the page exists before creating a duplicate.
 +
 
 +
===Long Term Projects===
 +
These are larger scale projects that often involve structural or organizational changes. Some can be easy to contribute to piece by piece even if you don't have time to tackle the whole thing. Behind the priority pages from the bubble map, these projects can be considered highly important.
 +
 
 +
====Current Projects:====
 +
*Update — Consolidating is problematic because if the pages are too long, the save edit function will not work, resulting in Error message 500. Also, super-lengthy pages could feel overwhelming.
 +
#The Cradle Characters and Cradle Glossary have a lot of overlap. They need to be consolidated and a direction for character navigation needs to be decided on.
 +
#The Valinhall Page has had all of its content divided onto separate sub-pages. Most of this information should be brought back to the Valinhall page and the subpages removed.
 +
#The Sacred Arts page is one of the best pages on the wiki with a wealth of detailed and clear information. However, it is extremely lengthy and certain other pages that are linked from here are hard to access. Custom navigation templets should be added and some organizational inspiration may be necessary.
 +
*Because it was so long, I have divided the old sacred arts page into two pages: [[Sacred Arts]] and [[Advancement Level]]
 +
 
 +
===Free Roaming===
 +
Feel free to also just roam around and look for things you want to add! If you see content missing from a page, something that should be rewritten, or find a broken link that leads nowhere feel free to step in. Any and all help is greatly appreciated.
 +
 
 +
==Style and Theme Conventions==
 +
 
 +
===Page Templates===
 +
Certain types of pages are all about very similar things, for instance every character of import has their own character page. Because each of these pages require many of the same things, they are standardized and there is a dedicated template to dictate the structure of those types of pages. Some pages are unique and need not follow such guidelines, but if you are working on one of the standardized types of pages please use the relevant template.  If the relevant template does not yet exist, feel free to make one!
 +
 
 +
*[[Cradle Character Page Template]]
 +
*[[Path Page Template]]
 +
*[[Elder Empire Character Page Template]]
 +
*[[Travelers Gate Character Page Template]]
 +
*[[Book Page Template]]
 +
 
 +
===Common Errors===
 +
We're generating a lot of content on this wiki and errors and spelling mistakes happen to the best of us. Below is a list of common errors to look out for either when adding new content or correcting old content:
 +
{| class="wikitable article-table"
 
!Error
 
!Error
 
!Correction
 
!Correction
Line 33: Line 80:
 
|Iron body
 
|Iron body
 
|}
 
|}
Here are some more things you can do:
 
  
*'''Building up''': Check out the [[:Category:Stubs|Stubs]]; articles that have not received substantial attention from other editors and do not have a sufficient amount of information and/or references can be a great place to start.
+
===In-Page Templates===
*'''Expand and Improve''': Many articles can be expanded and improved upon. You could roam the wiki looking for topics you are familiar with that are too vague, missing information, or need re-wording of sentences and paragraphs so that they are more understandable. If you notice information that is missing from an article, add it.
+
There are many different custom in-page templates made for the Abidan Archive. These range from Navbars for each of the major trees in the wiki to quote boxes for clear references to the books and other material. Where ever they are useful try and use these templates as they make the wiki easier to read and navigate. Below is a list of the custom widgets and a short explanation of their use.
 +
 
 +
====Cradle Navbox====
 +
{{Cradle NavBox}}
 +
This should be on the top of every page in the Cradle Tree, it provides easy access to all of the major sections of the Cradle Sub-tree. It requires no customization.
  
If you want to discuss anything specific to an article, you can use the Discussion page for that article.
+
====TG Navbox====
 +
{{TG Navbox}}
 +
This should be on the top of every page in the Travelers Gate Tree, it provides easy access to all of the major sections of the Travelers Gate Sub-tree. It requires no customization.
  
A mind map showing the wiki's organization can be found below, the color legend should be up to date, contact u/Madraast on the wiki and Reddit or @Phat Delicious Butternut Squash on the discord with any errors you find or suggested edits. You can also make edits yourself if you make an account.
+
====EE Navbox====
 +
{{EE Navbox}}
 +
This should be on the top of every page in the Travelers Gate Tree, it provides easy access to all of the major sections of the Travelers Gate Sub-tree. It requires no customization.
  
https://miro.com/app/board/o9J_kxpflKM=/
+
====Quote Box====
 +
{{Quote Box|title=Relevant Quote|quote=''"Example quote here"''|source=-John Smith|align=left}}
  
<br />
 
  
==Style Guides and Editing Help==
 
<br />
 
===Style Guide for "Books" pages===
 
Book pages should have at least three sections.
 
  
'''From the back cover:'''  Word for word the back cover blurb.  Left justified, in italics.  This needs an attribution, as it is a quote.
 
  
'''Summary''': A summary of the book.  This should include any major plot points of the book.  It is tempting to include everything, but try to keep it to major plot points or things that will be significant for future books.  Use sub-heading 2 format for any subheadings you may need.  This should be left aligned, with a single line between paragraphs.  Do not indent the first line.  Short quotes should be left in the text.  Longer quotes should use block quote formatting.
+
<br />
  
'''Characters:'''  Include any major or secondary characters, as well as any characters that may be significant in past or future books.  Focus on new information about that character from the book being discussed. Add the Character template info box to provide a summary of basic information.  
+
Any quotes from the books or other material should be placed in these. There is a wealth of customization available for these templates, but the only necessary ones are "quote" and "source". You can use "title" to add a label or "align" to change where on the page the quote box displays.
  
'''Other categories:''' Include other categories if needed, including items, locations or Paths. Focus on information that was new that book, and that is significant.  Remember there will be other areas that focus on these categories, so use these if it is needed for understanding the book.
+
====Character Templates====
 +
One of these templates should be present on every character page in every tree, choose the relevant character template for the tree. It provides an easy summary of important information and showcases a character portrait. Every field in this template is optional, fill out as many sections as you can and the rest will simply not be present on the template.
  
'''General notes:'''  If more detailed information is available elsewhere, link to it the first time it is mentioned. Subsequent mentions do not need to be linked. Spoilers are to be expected, but use your judgement for significant spoilers. All series related pages should start with their relevant navbox, e.g. (Cradle navbox on Cradle pages, EE navbox on EE pages)
+
[[Template:TG Character]]
 +
{| width="100%"
 +
|- style="font-size: 130%;"
 +
! width="25%" |Cradle
 +
! width="25%" |Elder Empire
 +
! width="25%" |Travelers Gate
 +
|}
 +
{| width="100%"
 +
|- style="font-size: 130%;"
 +
! width="25%" |{{Cradle Character
 +
|image=Drolls.png
 +
|Rank=Overlindon
 +
|Path= White Fox
 +
|Name=Eithan
 +
|Mom=Shera
 +
|Dad=Simon
 +
|Sibling=[[Yerin Arelius]]
 +
|Faction=Dreadgods
 +
|First Appearance=City of Light
 +
|Home=Sanctum|Origin=The happy dreams of children|Type Parents Unkown=Parents Unknown|Species=Janitor}}
 +
! width="25%" |{{EE Character
 +
|Name=Shera
 +
|Soulbound Vessel=Broom
 +
|Profession=Soulsmith
 +
|Guild=Akura
 +
|Type Unknown=Unknown
 +
|Home=Valinhall
 +
|First Appearance=Unsouled
 +
|image=Will wight potrait.png}}
 +
! width="25%" |{{TG Character|Name=Kai|Mom=Unknown|Dad=Naru Gwei|Type Parents Unkown=Parents Unknown|Territory=Avernus|First Appearance=Crimson Vault|Sibling=Orthos|Origin=A Valinhall Closet|Species=Sacred Squirrel|Faction=Imperial|Home=Naraka|Iteration=110|image=Lucan Arelius.jpg}}
 +
|}
  
The following page contains examples of templates to be used on various pages to help with organization and style.
 
 
[[Test page|test page]]
 
[[Test page|test page]]
  
 
===Using Quotes===
 
To keep things looking uniform, please use the Quote Template when adding quotes to pages. In source editor, it will look like this:
 
<div style="background-color:light-grey;">
 
<nowiki>{{Quote</nowiki>
 
 
| quote: this is where the quote text goes
 
| speaker: John Smith
 
| source: Welcome
 
 
<nowiki>}}</nowiki>
 
</div>
 
 
this will result in quote text like this:
 
 
{{Quote|quote=this is where the quote text goes|speaker=John Smith|source=Welcome}}
 
 
If you have a multiple line quote, separate the lines with a line break: like this <nowiki><br /></nowiki>, this will allow the italic formatting to hold for the entire paragraph of the quote, instead of only the first line.
 
 
for example. a quote like this:
 
 
{{Quote
 
|quote= first line of text<br /><br />second line of text<br /><br />third line of text
 
|speaker= John Smith
 
|source=Welcome
 
}}
 
 
This would look like this:
 
 
<nowiki>{{ Quote</nowiki>
 
 
<nowiki>|</nowiki> quote: first line of text <nowiki><br /></nowiki> <nowiki><br /></nowiki>second line of text <nowiki><br /></nowiki> <nowiki><br /></nowiki>third line of text
 
| speaker: John Smith
 
| source: Welcome
 
 
<nowiki>}}</nowiki>
 
 
[[Priority Projects]]
 
[[Priority Projects]]

Revision as of 21:54, 14 January 2022

All wiki contributors are welcome and greatly appreciated, here you will find information on priority work, style guides and long term projects. To get approved for editing please contact one of our moderators, LilBlue or TransEmo who can set up your permissions. Thank you so much, we really appreciate it!

Relevant Plea
"We need more wiki contributors"

-Maadrast





What to work on?

New Pages and Completing half finished ones

The Abidan Archives are organized in a tree format following the guides lain out in the bubble tree linked below.

Wiki Structure Guide

This map guides the overall organization of the wiki and is periodically updated to reflect the completeness of any given page. If you are looking to add new pages to the wiki or complete unfinished ones this is a good place to start. Pages on the map are categorized in one of four ways.

  • Purple: These are Priority Pages, these pages have been deemed important but either empty or unfinished. If you can, these are the most important pages to work on.
  • White: These are simply empty pages, many of these pages are linked too from others but have no content, you can easily navigate to one of these pages and start filling them out.
  • Yellow: These are half finished pages, there is some content here but it either needs to be updated after a new release, or finished if it simply does not contain all of the necessary info.
  • Green: These are finished pages! One day all of the pages will be green! Some of these pages may still need updating if they have fallen behind, but they are pretty solid and don't need much work.

If you find any errors in the map, or you have updated something you can contact Maadrast who supposedly maintains it, or make an account and edit it yourself.

  • Note — this map/tree Maadrast made is excellent, but it’s out of date. I have completed many of the pages, highlighted on the map in purple, white, or yellow. So check around to see if the page exists before creating a duplicate.

Long Term Projects

These are larger scale projects that often involve structural or organizational changes. Some can be easy to contribute to piece by piece even if you don't have time to tackle the whole thing. Behind the priority pages from the bubble map, these projects can be considered highly important.

Current Projects:

  • Update — Consolidating is problematic because if the pages are too long, the save edit function will not work, resulting in Error message 500. Also, super-lengthy pages could feel overwhelming.
  1. The Cradle Characters and Cradle Glossary have a lot of overlap. They need to be consolidated and a direction for character navigation needs to be decided on.
  2. The Valinhall Page has had all of its content divided onto separate sub-pages. Most of this information should be brought back to the Valinhall page and the subpages removed.
  3. The Sacred Arts page is one of the best pages on the wiki with a wealth of detailed and clear information. However, it is extremely lengthy and certain other pages that are linked from here are hard to access. Custom navigation templets should be added and some organizational inspiration may be necessary.

Free Roaming

Feel free to also just roam around and look for things you want to add! If you see content missing from a page, something that should be rewritten, or find a broken link that leads nowhere feel free to step in. Any and all help is greatly appreciated.

Style and Theme Conventions

Page Templates

Certain types of pages are all about very similar things, for instance every character of import has their own character page. Because each of these pages require many of the same things, they are standardized and there is a dedicated template to dictate the structure of those types of pages. Some pages are unique and need not follow such guidelines, but if you are working on one of the standardized types of pages please use the relevant template. If the relevant template does not yet exist, feel free to make one!

Common Errors

We're generating a lot of content on this wiki and errors and spelling mistakes happen to the best of us. Below is a list of common errors to look out for either when adding new content or correcting old content:

Error Correction
Aurelius Arelius
Cassius Cassias
Sacred Artist (capitalisation) sacred artist
cradle Cradle
path Path
Madra madra
Path of Blackflame Path of Black Flame
Iron Body Iron body

In-Page Templates

There are many different custom in-page templates made for the Abidan Archive. These range from Navbars for each of the major trees in the wiki to quote boxes for clear references to the books and other material. Where ever they are useful try and use these templates as they make the wiki easier to read and navigate. Below is a list of the custom widgets and a short explanation of their use.

Cradle Navbox

This should be on the top of every page in the Cradle Tree, it provides easy access to all of the major sections of the Cradle Sub-tree. It requires no customization.

TG Navbox

This should be on the top of every page in the Travelers Gate Tree, it provides easy access to all of the major sections of the Travelers Gate Sub-tree. It requires no customization.

EE Navbox

This should be on the top of every page in the Travelers Gate Tree, it provides easy access to all of the major sections of the Travelers Gate Sub-tree. It requires no customization.

Quote Box

Relevant Quote
"Example quote here"

-John Smith




Any quotes from the books or other material should be placed in these. There is a wealth of customization available for these templates, but the only necessary ones are "quote" and "source". You can use "title" to add a label or "align" to change where on the page the quote box displays.

Character Templates

One of these templates should be present on every character page in every tree, choose the relevant character template for the tree. It provides an easy summary of important information and showcases a character portrait. Every field in this template is optional, fill out as many sections as you can and the rest will simply not be present on the template.

Template:TG Character

Cradle Elder Empire Travelers Gate
Eithan
Drolls.png
General information
PathWhite Fox
RankOverlindon
FactionDreadgods
First AppearanceCity of Light
SpeciesJanitor
OriginThe happy dreams of children
Family
MotherShera
FatherSimon
HomeSanctum


Shera
Will wight potrait.png
General information
GuildAkura
ProfessionSoulsmith
Soulbound VesselBroom
First AppearanceUnsouled
Family
ParentsUnknown
HomeValinhall


Kai
Lucan Arelius.jpg
General information
Iteration110
TerritoryAvernus
FactionImperial
First AppearanceCrimson Vault
SpeciesSacred Squirrel
OriginA Valinhall Closet
Family
MotherUnknown
FatherNaru Gwei
SiblingOrthos
ParentsParents Unknown
HomeNaraka


test page

Priority Projects